Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

API 토큰 생성

API 토큰은 인증 정보를 포함하며 특정 사용자 또는 전체 조직에 바인딩됩니다. API 토큰은 보안을 보장하기 위해 사용자 또는 조직에 대한 식별 정보를 API 서버로 전송하여 사용자가 API에 액세스할 수 있는지 여부를 나타냅니다.

다른 많은 API 프로바이더와 마찬가지로 Juniper Mist는 HTTP 헤더에서 인증을 위한 API 토큰을 생성하는 방법을 제공합니다. 토큰을 고려할 때 Juniper Mist는 토큰 라는 용어를 같은 의미로 사용합니다.

사용자 API 토큰과 관련된 특성은 다음과 같습니다.

  • API 토큰은 할당된 사용자의 계정 권한과 동일한 권한을 가정합니다.

  • Juniper Mist는 90일 동안 사용하지 않은 API 토큰을 자동으로 제거합니다.

  • Juniper Mist API의 기본 URI(Uniform Resource Identifier)는 {api_endpoint}/api/v1/입니다.

    참고:

    {api_endpoint} 대신 글로벌 리전의 API 엔드포인트를 사용해야 합니다. API 엔드포인트 및 글로벌 리전을 참조하십시오.

주니퍼 Mist에는 두 가지 유형의 API 토큰이 있습니다.
  • 조직 토큰

    • 토큰은 Mist 조직에서 유지됩니다.
    • 토큰은 특정 사용자에게 바인딩되지 않으므로 액세스 권한이 조직에 대한 사용자의 액세스 권한에 의존하지 않습니다.
    • 다른 권한을 가질 수 있는 N 조직 토큰을 지원합니다.
    • 토큰은 해당 특정 조직에만 사용할 수 있습니다.
    • 속도 제한은 개별 토큰에 의해 수행됩니다. 예를 들어 OrgToken1이 5000개의 API 호출을 사용하고 속도 제한에 도달하는 경우 OrgToken2는 영향을 받지 않습니다.
  • 사용자 토큰

    • 토큰은 특정 사용자 계정에 유지됩니다.
    • 토큰은 특정 사용자에게 바인딩되며, 이는 액세스가 조직에 대한 사용자의 액세스와 직접적인 상관 관계가 있음을 의미합니다.
    • 이 토큰은 사용자가 액세스할 수 있는 모든 MSP(관리 서비스 공급자) 또는 조직에 사용할 수 있습니다.
    • 모두 사용자 계정과 동일한 권한을 가진 N 개의 토큰을 지원합니다.
    • 속도 제한은 사용자와 연결된 계정에 의해 수행됩니다. 예를 들어 UserToken1이 5000개의 API 호출을 사용하고 속도 제한에 도달하면 UserToken2 및 GUI에 대한 계정 로그인이 영향을 받습니다.

조직 토큰 만들기

  1. Juniper Mist 포털의 왼쪽 메뉴에서 조직(Organization) > 설정(Settings)으로 이동합니다.
  2. API Token(API 토큰) 섹션까지 아래로 스크롤하고 Create Token(토큰 생성)을 클릭합니다.
  3. 토큰에 대한 사용 권한을 정의합니다.

  4. 생성을 클릭합니다.
    • 생성을 클릭하면 창 맨 위에 키를 저장해야 한다는 메시지가 표시됩니다.

  5. 필드 옆에 있는 복사 버튼을 클릭하여 키를 복사하고 안전한 보관을 위해 어딘가에 보관하십시오.
    참고:

    잘리지 않은 전체 키를 볼 수 있는 유일한 시간은 생성 시입니다. 전체 키를 다시는 볼 수 없습니다. 키를 잃어버린 경우 새 키를 만들어야 합니다.

  6. 창 하단에서 완료를 클릭합니다.
  7. 페이지의 오른쪽 상단 모서리에 있는 저장을 클릭합니다.

REST API 탐색기를 사용하여 사용자 토큰 만들기Create a User Token using the REST API Explorer

  1. Juniper Mist 포털에 로그인합니다(REST API Explorer를 사용하기 전에 Mist 포털에 로그인해야 함).
  2. 새 브라우저 창을 열고 REST API 탐색기{api_endpoint}/api/v1/self/apitokens에 URL을 붙여넣습니다.
    참고:

    {api_endpoint} 대신 글로벌 리전의 API 엔드포인트를 사용해야 합니다. API 엔드포인트 및 글로벌 리전을 참조하십시오.

    REST API 탐색기는 토큰 제어를 위한 API 페이지입니다. 여기에서 토큰 및 토큰 정보를 만들고, 읽고, 업데이트하고, 삭제할 수 있습니다. 이 페이지에는 처음에 이미 만든 토큰이 표시됩니다.

    또한 이 페이지에서는 사용자와 다른 사용자가 브라우저에서 직접 API를 호출할 수 있습니다. 미디어 유형: applications/json 이 기본값으로 이미 선택되어 있으면 토큰 목록을 표시하기 위해 GET 요청이 수행됩니다. 이전에 만든 토큰에 대해 잘린 키가 표시됩니다.

  3. POST 단추를 클릭하여 토큰을 만듭니다.

    참고:

    Juniper Mist API는 키를 생성한 후 실제 토큰() 전체를 어디에도 다시 표시하지 않습니다. 이 페이지에서 벗어났다가 다시 돌아오면 키가 잘린 버전으로 표시됩니다. 이 키는 암호로 취급하여 안전한 장소에 보관해야 합니다. 이 키를 분실한 경우 새 키를 만들어야 합니다.

    수신된 응답은 다음 예제와 같아야 합니다.