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는 토큰 과 키 라는 용어를 같은 의미로 사용합니다.

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

  • 조직 토큰

    조직 토큰은 조직의 작업을 자동화하는 응용 프로그램을 빌드할 때 유용합니다. 여러 사용자가 응용 프로그램에 액세스해야 하므로 인증에 동일한 조직 토큰을 사용하게 됩니다.

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

  • 사용자 토큰

    사용자 토큰은 예를 들어 스크립트를 실행할 때와 같이 직접 인증해야 하는 경우에 유용합니다.

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

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

Mist 포털 또는 REST API 탐색기를 통해 API 토큰을 생성할 수 있습니다.

Mist 포털에서 조직 토큰 생성

  1. Juniper Mist 포털의 왼쪽 메뉴에서 조직(Organization) > 관리자(Admin) > 설정(Settings)을 선택합니다.
  2. API Token(API 토큰) 섹션까지 아래로 스크롤하고 Create Token(토큰 생성)을 클릭합니다.
  3. Access Level(액세스 수준)을 선택하여 토큰에 대한 사용 권한을 정의합니다.

  4. 생성을 클릭합니다.
  5. 키 필드 옆에 있는 복사 버튼을 클릭하고 보관을 위해 어딘가에 보관합니다.
    메모:

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

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

Mist 포털에서 사용자 토큰 생성

Mist 포털의 내 계정 페이지에서 API 사용자 토큰을 생성할 수 있습니다.

API 사용자 토큰을 생성하려면 다음을 수행합니다.

  1. Juniper Mist 포털의 오른쪽 상단에서 Juniper Mist 계정 아이콘을 클릭한 다음 내 계정을 클릭합니다.
  2. API Token(API 토큰) 섹션에서 Create Token(토큰 생성)을 클릭합니다. 조직에 Single Sign-On을 사용하도록 설정한 경우 API 사용자 토큰을 만들 수 없습니다.
  3. 토큰의 이름을 입력하고 생성을 클릭합니다. 생성된 키는 사용자 API 토큰입니다.
  4. 키 필드 옆에 있는 복사 버튼을 클릭합니다.

    전체 키를 다시 볼 수 없으므로 안전하게 보관할 수 있도록 키를 보관해야 합니다. 키를 분실한 경우 새 키를 만들어야 합니다.

  5. 완료를 클릭합니다.
    메모:

    사용자 토큰을 삭제해야 하는 경우 내 프로필 페이지의 API 토큰 섹션에서 토큰을 클릭한 다음 토큰 편집 페이지에서 삭제 를 클릭합니다.

REST API 탐색기를 사용하여 사용자 또는 조직 토큰 만들기

  1. Juniper Mist 포털에 로그인합니다.
    메모:

    REST API Explorer를 사용하려면 포털에 로그인해야 합니다.
  2. 새 브라우저 창을 열고 URL{api-host}/api/v1/self/apitokens을 붙여넣습니다.
    메모:

    {api-host} 대신 글로벌 지역에 대한 API 엔드포인트를 사용해야 합니다. API 엔드포인트 및 글로벌 리전을 참조하십시오.

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

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

  3. 게시를 클릭합니다.

    응답은 다음 예제와 유사합니다.

  4. 키(토큰)를 복사하고 보관을 위해 저장합니다.
    메모:

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