1단계: 클라이언트 자격 증명 저장
OIDC 앱을 생성하면 Iru가 클라이언트 ID와 클라이언트 시크릿을 생성합니다. 시크릿은 한 번만 표시되므로 대화 상자를 닫기 전에 둘 다 안전한 곳에 복사하세요. 앱의 Protocol details에는 서비스가 Iru와 통신하는 데 필요한 엔드포인트도 나열됩니다.2단계: 리디렉션 URI 설정
앱의 초안에서 OIDC 설정 아래에 Iru가 리디렉션할 수 있는 URI를 추가합니다.1
허용된 로그인 리디렉션 URI
로그인 성공 후 Iru가 사용자를 돌려보내는 곳입니다. 서비스가 사용하는 모든 URL을
추가하세요.
2
허용된 로그아웃 리디렉션 URI
로그아웃 후 Iru가 사용자를 돌려보내는 곳입니다.
리디렉션 URI는 정확히 일치해야 합니다. 리디렉션 URI에 와일드카드를 허용하는
옵션이 있지만, 정확한 일치가 더 안전하므로 서비스에서 특별히 요구하지 않는 한
꺼 두세요.
3단계: 스코프 선택
스코프는 서비스가 요청할 수 있는 클레임 범주를 제어합니다. Iru는 표준 OpenID Connect 스코프를 제공합니다.4단계: Subject 및 클레임 매핑
애플리케이션의 매핑을 엽니다. 매핑에는 제목과 추가 클레임이 있습니다.Subject
Subject는 로그인한 사용자의 기본 식별자이며sub 클레임으로 전송됩니다. OIDC
앱의 경우 기본 Subject는 사용자의 user.id에서 매핑됩니다. 값을 가져오는 소스를
변경하고 스코프와 연결할 수 있습니다.
클레임
서비스가 ID 토큰에서 기대하는 추가 클레임을 추가합니다. 각 클레임에 대해 다음을 설정합니다.- Name: 클레임 이름.
- 값: 값을 가져오는 프로필 속성 또는 표현식.
- 스코프: 클레임이 속한 스코프.
- 활성화 여부.
5단계: 클라이언트 시크릿 교체
클라이언트 시크릿은 앱을 다시 생성하지 않고 앱의 Protocol details → Client secrets에서 교체할 수 있습니다.교체
교체
Rotate는 새 클라이언트 시크릿을 발급하며, 이전 시크릿은 24시간 동안 계속
작동하므로 이전 시크릿이 중지되기 전에 서비스를 업데이트할 수 있습니다. 이 기간
동안 이전 시크릿은 Expires Soon 배지와 함께 나열되며, 새로 발급된 시크릿은
장기간 유효합니다.
무효화
무효화
Invalidate는 유예 기간 없이 현재 시크릿을 즉시 종료합니다. 시크릿이 노출되었을
수 있는 경우 사용하고, 즉시 서비스를 업데이트하세요.
Iru는 ID 토큰 서명에 사용하는 서명 키를 관리하고 검색 및 키 엔드포인트에
게시하므로, 서비스가 토큰을 자동으로 검증합니다. 수동으로 교체할 것이 없습니다.
6단계: 게시, 할당 및 활성화
1
초안을 current로 설정
초안을 게시하여 실시간 구성으로 만듭니다.
2
액세스 할당
앱을 사용해야 하는 그룹을 할당합니다.
액세스 할당을 참조하세요.
3
활성화
할당된 사용자가 로그인할 수 있도록 앱을 활성화합니다.
4
로그인 테스트
앱 대시보드에서 테스트 사용자로 로그인하여 경험을 확인합니다.
인증 흐름
OIDC 앱은 인증 코드 흐름으로 사용자를 로그인시킵니다.1
Iru로 리디렉션
앱이 로그인을 위해 사용자를 Iru로 보냅니다.
2
인증 및 정책 평가
Iru가 사용자를 인증하고 앱의
인증 정책을 평가합니다.
3
인증 코드 반환
Iru가 수명이 짧은 인증 코드와 함께 앱의 리디렉션 URI로 다시
리디렉션합니다.
4
코드를 토큰으로 교환
앱이 Iru의 토큰 엔드포인트에서 코드를 ID 토큰(사용자가 누구인지)과
액세스 토큰으로 교환합니다.
5
클레임 읽기(및 로그인 유지)
앱은 액세스 토큰으로 사용자 정보 엔드포인트를 호출하여 프로필 클레임을 읽을
수 있으며, (
offline_access를 활성화한 경우) 새로 고침 토큰을 사용하여
로그인 상태를 유지할 수 있습니다.다음 단계
액세스 할당
사용자 및 그룹에 앱을 부여합니다.
프로비저닝
액세스가 변경되면 앱에서 계정을 자동으로 생성하고 제거합니다.
인증 정책
로그인할 수 있는 사람과 증명해야 하는 내용을 결정합니다.
애플리케이션 개요
프로토콜과 초안에서 current로의 버전 모델을 검토합니다.