GitLab에서 OIDC/OAuth 테스트
GitLab에서 OIDC/OAuth를 테스트하려면 다음을 수행해야 합니다:
필수 조건
GitLab에서 OIDC/OAuth를 테스트하기 전에 다음을 충족해야 합니다:
- 공개적으로 접근 가능한 GitLab 셀프 관리 인스턴스가 있어야 합니다.
- 해당 인스턴스의 관리자인 경우.
- OIDC/OAuth 테스트에 사용할 클라이언트 애플리케이션이 있어야 합니다.
GitLab에서 OIDC/OAuth 활성화
먼저, GitLab 인스턴스에서 OIDC/OAuth 애플리케이션을 생성해야 합니다. 이를 위해:
- 왼쪽 사이드바에서 아래로 스크롤하여 Admin을 선택합니다.
- Applications를 선택합니다.
- Add new application을 선택합니다.
- 클라이언트 애플리케이션의 세부정보를 입력합니다(이름, 리디렉션 URI 및 허용된 범위 포함).
-
openid
범위가 활성화되어 있는지 확인합니다. - Save application을 선택하여 새로운 OAuth 애플리케이션을 생성합니다.
클라이언트 애플리케이션으로 OIDC/OAuth 테스트
GitLab에서 OAuth 애플리케이션을 생성한 후, 이를 사용하여 OIDC/OAuth를 테스트할 수 있습니다:
- https://openidconnect.net를 OIDC/OAuth 놀이터로 사용할 수 있습니다.
- GitLab에서 로그아웃합니다.
- 클라이언트 애플리케이션을 방문하고 이전 단계에서 만든 GitLab OAuth 애플리케이션을 사용하여 OIDC/OAuth 흐름을 시작합니다.
- GitLab에 로그인하고 클라이언트 애플리케이션이 귀하의 GitLab 계정에 액세스할 수 있도록 권한을 부여합니다.
- OIDC/OAuth 흐름을 완료한 후, 클라이언트 애플리케이션은 GitLab과 인증하기 위해 사용할 수 있는 액세스 토큰을 받아야 합니다.
OIDC/OAuth 인증 확인
GitLab에서 OIDC/OAuth 인증이 제대로 작동하는지 확인하려면 다음 검사를 수행할 수 있습니다:
-
이전 단계에서 받은 액세스 토큰이 유효하며 GitLab과 인증하는 데 사용할 수 있는지 확인합니다. 이를 위해 액세스 토큰을 사용하여 GitLab에 테스트 API 요청을 할 수 있습니다. 예:
curl --header "Authorization: Bearer <access_token>" https://mygitlabinstance.com/api/v4/user
<access_token>
을 이전 단계에서 받은 실제 액세스 토큰으로 교체합니다. API 요청이 성공하고 인증된 사용자에 대한 정보를 반환하면 OIDC/OAuth 인증이 올바르게 작동하는 것입니다. -
OAuth 애플리케이션에서 지정한 범위가 올바르게 적용되고 있는지 확인합니다. 특정 범위를 요구하는 API 요청을 수행하고 성공 여부나 실패 여부를 확인함으로써 이를 확인할 수 있습니다.
이게 전부입니다! 이러한 단계로 클라이언트 애플리케이션을 사용하여 GitLab 인스턴스에서 OIDC/OAuth 인증을 테스트할 수 있습니다.