GitLab에서 OIDC/OAuth를 테스트하려면 다음 절차를 수행합니다.

1. OIDC/OAuth 활성화
2. 클라이언트 애플리케이션으로 OIDC/OAuth 테스트
3. OIDC/OAuth 인증 확인

사전 요구 사항#

GitLab에서 OIDC/OAuth를 테스트하려면 다음 조건을 충족해야 합니다.

• 외부에서 접근할 수 있는 인스턴스가 있어야 합니다.
• 해당 인스턴스의 관리자여야 합니다.
• OIDC/OAuth 테스트에 사용할 클라이언트 애플리케이션이 있어야 합니다.

GitLab에서 OIDC/OAuth 활성화#

먼저 GitLab 인스턴스에 OIDC/OAuth 애플리케이션을 만들어야 합니다. 절차는 다음과 같습니다.

1. 오른쪽 상단에서 Admin을 선택합니다.
2. 왼쪽 사이드바에서 Applications를 선택합니다.
3. Add new application을 선택합니다.
4. 이름, 리디렉션 URI, 허용 스코프를 포함해 클라이언트 애플리케이션의 세부 정보를 입력합니다.
5. openid 스코프가 활성화되어 있는지 확인합니다.
6. Save application을 선택해 새 OAuth 애플리케이션을 생성합니다.

클라이언트 애플리케이션으로 OIDC/OAuth 테스트#

GitLab에서 OAuth 애플리케이션을 만든 뒤에는 이를 사용해 OIDC/OAuth를 테스트할 수 있습니다.

1. OIDC/OAuth 플레이그라운드로 https://openidconnect.net을 사용할 수 있습니다.
2. GitLab에서 로그아웃합니다.
3. 클라이언트 애플리케이션에 접속해, 앞 단계에서 만든 GitLab OAuth 애플리케이션으로 OIDC/OAuth 플로를 시작합니다.
4. 안내에 따라 GitLab에 로그인하고, 클라이언트 애플리케이션이 GitLab 계정에 접근하도록 승인합니다.
5. OIDC/OAuth 플로를 마치면 클라이언트 애플리케이션은 GitLab 인증에 사용할 수 있는 액세스 토큰을 받게 됩니다.

OIDC/OAuth 인증 확인#

GitLab에서 OIDC/OAuth 인증이 올바르게 동작하는지 확인하려면 다음 항목을 점검합니다.

1. 앞 단계에서 받은 액세스 토큰이 유효하며 GitLab 인증에 사용할 수 있는지 확인합니다. 액세스 토큰으로 인증하는 테스트 API 요청을 GitLab에 보내 확인할 수 있습니다. 예를 들면 다음과 같습니다.

   curl --header "Authorization: Bearer <access_token>" https://mygitlabinstance.com/api/v4/user
   

   <access_token>은 앞 단계에서 받은 실제 액세스 토큰으로 바꿉니다. API 요청이 성공하고 인증된 사용자 정보가 반환되면 OIDC/OAuth 인증이 올바르게 동작하는 것입니다.

2. OAuth 애플리케이션에 지정한 스코프가 올바르게 적용되는지 확인합니다. 특정 스코프가 필요한 API 요청을 보내고, 예상대로 성공하거나 실패하는지 확인하면 됩니다.

이 단계를 따르면 클라이언트 애플리케이션을 사용해 GitLab 인스턴스에서 OIDC/OAuth 인증을 테스트할 수 있습니다.