5장. 클라이언트 등록 서비스 사용

전달자 토큰은 사용자 또는 서비스 계정을 대신하여 발행할 수 있습니다. 끝점을 호출하려면 다음 권한이 필요합니다(자세한 내용은 Server Administration Guide 참조).

전달자 토큰을 사용하여 클라이언트를 생성하는 경우 create-client 역할만 사용하여 서비스 계정의 토큰을 사용하는 것이 좋습니다(자세한 내용은 Server Administration Guide 참조).

새 클라이언트를 등록하기 위한 권장 방법은 초기 액세스 토큰을 사용하는 것입니다. 초기 액세스 토큰은 클라이언트를 생성하는 데만 사용할 수 있으며 구성 가능한 만료와 생성할 수 있는 클라이언트 수에 대한 구성 가능한 제한이 있습니다.

초기 액세스 토큰은 관리 콘솔을 통해 생성할 수 있습니다. 새 초기 액세스 토큰을 생성하려면 먼저 관리 콘솔의 영역을 선택한 다음 왼쪽의 메뉴에서 settings를 클릭한 다음 페이지에 표시된 탭에 있는 클라이언트 등록이 표시됩니다. 그런 다음 Initial Access Tokens 하위 탭을 클릭합니다.

이제 기존 초기 액세스 토큰을 볼 수 있습니다. 액세스 권한이 있는 경우 더 이상 필요하지 않은 토큰을 삭제할 수 있습니다. 토큰을 생성할 때만 토큰 값을 검색할 수 있습니다. 새 토큰을 생성하려면 생성을 클릭합니다. 토큰을 사용하여 생성할 수 있는 클라이언트 수를 선택적으로 추가할 수 있습니다. 저장 을 클릭하면 토큰 값이 표시됩니다.

나중에 검색할 수 없으므로 지금 이 토큰을 복사하거나 붙여 넣는 것이 중요합니다. 복사/붙여넣기를 잊어 버린 경우 토큰을 삭제하고 다른 토큰을 생성합니다.

토큰 값은 클라이언트 등록 서비스를 호출할 때 요청의 Authorization 헤더에 추가하여 표준 전달자 토큰으로 사용됩니다. 예를 들면 다음과 같습니다.

Authorization: bearer eyJhbGciOiJSUz...

Authorization: bearer eyJhbGciOiJSUz...

클라이언트 등록 서비스를 통해 클라이언트를 생성하면 응답에 등록 액세스 토큰이 포함됩니다. 등록 액세스 토큰에서는 나중에 클라이언트 구성을 검색할 수 있는 액세스 권한을 제공하지만 클라이언트를 업데이트하거나 삭제할 수도 있습니다. 등록 액세스 토큰은 전달자 토큰 또는 초기 액세스 토큰과 동일한 방식으로 요청에 포함됩니다. 등록 액세스 토큰은 응답에 사용되는 경우 새 토큰이 포함된 한 번만 유효합니다.

클라이언트 등록 서비스 외부에서 클라이언트를 생성한 경우 연결된 등록 액세스 토큰이 없습니다. 관리 콘솔을 통해 이를 생성할 수 있습니다. 이는 특정 클라이언트의 토큰을 손실한 경우에도 유용할 수 있습니다. 새 토큰을 생성하려면 관리 콘솔에서 클라이언트를 찾고 자격 증명을 클릭합니다. 그런 다음 Generate registration access token 을 클릭합니다.