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에 액세스할 수 있는지 여부를 나타냅니다.

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

주의: 2026년 9월 이전에 모든 통합은 중단 없는 액세스 및 지원을 보장하기 위해 토큰 기반 인증으로 전환해야 합니다. 기본 인증은 보안을 강화하고 업계 모범 사례에 부합하기 위해 2026년 9월에 더 이상 사용되지 않습니다.
Juniper Mist에는 두 가지 유형의 API 토큰이 있습니다.

  • 조직 토큰

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

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

  • 사용자 토큰

    사용자 토큰은 예를 들어 스크립트를 실행할 때와 같이 자신을 인증해야 할 때 유용합니다.

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

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

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

Mist Portal에서 조직 토큰 생성

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

  4. Generate(생성)를 클릭합니다.
  5. 키 필드 옆에 있는 복사 버튼을 클릭하고 안전하게 보관할 수 있도록 어딘가에 저장합니다.
    메모:

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

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

Mist 포털에서 사용자 토큰 만들기

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

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

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

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

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

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

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

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

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

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

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

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

  3. POST를 클릭합니다.

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

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

    Juniper Mist API는 키를 만든 후 어디에도 실제 토큰(키) 전체를 다시 표시하지 않습니다. 이 페이지에서 나갔다가 다시 돌아오면 키가 잘린 버전으로 나타납니다. 이 키를 암호로 취급하고 안전한 장소에 저장해야 합니다. 이 키를 분실한 경우 새 키를 만들어야 합니다.
    메모:

    Python 스크립트를 다른 사람과 공유하려는 경우 스크립트 자체에 API 토큰을 저장하지 말고 대신 환경 파일(.mist_env)을 사용해야 합니다. 환경 파일은 스크립트에 중요한 정보를 저장하므로 스크립트에서 직접 중요한 정보를 공유할 필요가 없습니다. 자세한 내용은 https://github.com/tmunzer/mist_library?tab=readme-ov-file#environment-file 를 참조하십시오.