커스텀 SCIM 프로필을 사용한 자동 사용자 프로비저닝은 제한된 수의 참여자만 사용할 수 있는 베타 기능입니다. 앱의 세부정보 페이지에 자동 프로비저닝이 표시되지 않으면 아직 조직에서 사용할 수 없는 것입니다.
맞춤 SCIM 프로필을 사용한 자동 사용자 프로비저닝을 통해 SCIM 2.0을 지원하는 맞춤 또는 사전 통합된 SAML 앱에서 사용자 계정을 자동으로 설정하고 관리할 수 있습니다.
시작하기 전에
맞춤 SCIM 프로필을 설정하려면 다음이 필요합니다.
- 최고 관리자 역할이 있는 Cloud ID 계정 자세한 내용은 기본 제공 관리자 역할을 참고하세요.
- 관리 콘솔에서 사용자를 위해 설정되고 사용 설정된 맞춤 또는 사전 통합 SAML 앱
앱에 다음을 수행하는 SCIM 서버가 있어야 합니다.
- SCIM 버전 2.0 지원
POST,GET,PATCH(PUT로 대체),DELETE를 포함한 표준 HTTP 메서드를 사용합니다.- Bearer 토큰 인증을 지원합니다. OAuth 토큰 인증은 지원되지 않습니다.
커스텀 SCIM 프로필로 자동 사용자 프로비저닝 설정하기
-
Google 관리 콘솔에서 메뉴
앱
웹 및 모바일 앱으로 이동합니다.
이 작업을 수행하려면 최고 관리자로 로그인해야 합니다.
- SAML 앱의 이름을 클릭합니다.
- 자동 프로비저닝에서 자동 프로비저닝 구성을 클릭합니다.
- 액세스 토큰에 앱의 Bearer 토큰을 입력한 다음 계속을 클릭합니다.
- 엔드포인트 URL 입력란에 앱의 SCIM 엔드포인트 URL을 입력한 다음 계속을 클릭합니다. Google은 SCIM 엔드포인트에 연결하여 지원되는 속성을 자동으로 검색합니다.
- Google 디렉터리 속성을 해당 앱 속성에 매핑합니다. 앱에서 스키마 검색을 지원하는 경우 테이블에 검색된 속성이 자동 입력됩니다. 맞춤 속성을 수동으로 매핑하려면 매핑 추가를 클릭하고 완료되면
계속을 클릭합니다.
- (선택사항) 그룹을 추가하지 않으면 SAML 앱에 액세스할 수 있는 모든 사용자가 프로비저닝됩니다. 자동 프로비저닝을 특정 사용자 그룹으로 제한하려면 다음 안내를 따릅니다.
- 그룹 검색의 경우 그룹 이름의 글자를 하나 이상 입력하고 그룹 이름을 선택한 다음 범위를 선택합니다.
- 그룹을 더 추가합니다.
- (선택사항) 그룹을 삭제하려면 삭제를 클릭합니다.
그룹에 보조 도메인이나 조직 외부의 사용자가 있는 경우 해당 사용자는 프로비저닝되지 않습니다.
- 사용자를 대상으로 앱이 사용 중지되거나 사용자의 Google Workspace 계정이 정지 또는 삭제된 후 해당 사용자가 앱에 액세스할 수 있는 기간을 결정합니다. 계정을 정지하거나, 계정을 하드 삭제하거나, 계정을 정지한 후 하드 삭제할 수 있습니다. 각 작업에 대해 지연 기간을 개별적으로 설정할 수 있습니다.
- 필요에 따라 각 이벤트의 옵션을 선택합니다.
- 사용자에 대해 앱이 사용 중지된 경우
- Google에서 사용자가 정지된 경우
- Google에서 사용자가 삭제되는 경우
사용자 계정을 정지하면 비활성화된 것으로 표시됩니다. 사용자 계정을 하드 삭제하면 앱에서 영구적으로 삭제됩니다. 사용자 계정을 하드 삭제하는 데 걸리는 시간을 항상 더 길게 설정하세요. 정지 및 삭제에 관한 자세한 내용은 프로비저닝 해제 기간 수정하기를 참고하세요.
- 계속을 클릭합니다.
- 필요에 따라 각 이벤트의 옵션을 선택합니다.
연결을 테스트합니다.
- Google 디렉터리 사용자에서 앱에 계정이 없는 사용자를 검색하여 선택합니다.
테스트를 클릭합니다.
Google에서 앱에 사용자의 계정을 만들고 업데이트한 후 삭제합니다. 각 작업에는 성공, 실패 또는 실행되지 않음이 표시됩니다. 실패한 작업의 경우 앱에서 HTTP 코드, SCIM 오류 유형, 원시 응답 보기 세부정보를 검토합니다.
참고: 예를 들어 사용자가 이미 존재하여 앱이 신규 사용자에 대해
201 Created를 반환하지 않으면 사용자 만들기가 실패하고 Google은 업데이트 및 삭제 작업을 건너뜁니다. 사용자 삭제가 실패하면 앱에서 테스트 계정을 수동으로 삭제합니다.
마침을 클릭합니다.
테스트에 실패하더라도 완료를 클릭하고 나중에 다시 테스트할 수 있습니다. 이 단계에서는 구성을 저장하지만 자동 프로비저닝을 사용 설정하지는 않습니다. 사용 설정하려면 앱의 세부정보 페이지자동 프로비저닝으로 이동하여 전환 버튼을 활성으로 설정합니다.
참고: 사용자에 대해 앱이 사용 설정되지 않은 경우 이 설정은 사용 중지됩니다. 사용자 액세스를 클릭하고 앱을 사용 설정하여 자동 프로비저닝을 사용 설정합니다.
프로비저닝 정보 수정하기
자동 프로비저닝이 적용되는 사용자 그룹 수정하기
-
Google 관리 콘솔에서 메뉴
앱
웹 및 모바일 앱으로 이동합니다.
이 작업을 수행하려면 최고 관리자로 로그인해야 합니다.
- SAML 앱의 이름을 클릭합니다.
- 자동 프로비저닝을 클릭합니다.
- 프로비저닝 범위에서 수정을 클릭합니다.
- 그룹 검색의 경우 그룹 이름의 글자를 하나 이상 입력하고 그룹 이름을 선택한 다음 범위를 선택합니다.
- 그룹을 더 추가합니다.
- (선택사항) 그룹을 삭제하려면 삭제를 클릭합니다.
그룹에 보조 도메인이나 조직 외부의 사용자가 있는 경우 해당 사용자는 프로비저닝되지 않습니다. - 업데이트를 클릭합니다.
프로비저닝 해제 기간 수정하기
얼마 후 프로비저닝 해제 작업이 시작될 지 정의하려면 다음 안내를 따르세요.
-
Google 관리 콘솔에서 메뉴
앱
웹 및 모바일 앱으로 이동합니다.
이 작업을 수행하려면 최고 관리자로 로그인해야 합니다.
- SAML 앱의 이름을 클릭합니다.
- 자동 프로비저닝을 클릭합니다.
- 프로비저닝 해제에서 수정을 클릭합니다.
- 각 이벤트 (사용자에게 앱이 사용 중지된 경우, 사용자가 Google에서 정지된 경우, 사용자가 Google에서 삭제된 경우)에 대해 수행할 작업과 변경사항이 발생한 후 Google에서 앱에 요청을 보내기 전에 대기하는 시간 (24시간 이내 또는 1, 7, 21일 후)을 선택합니다.
- 사용자 계정 정지: 앱에서 사용자를 비활성화합니다 (
PATCH또는active: false를 사용하는PUT). - 사용자 계정 하드 삭제: 앱 (
DELETE /Users/{id})에서 사용자를 영구적으로 삭제합니다.
두 옵션을 모두 선택하는 경우 항상 하드 삭제의 지연 시간을 정지보다 길게 설정하세요. - 업데이트를 클릭합니다.
자동 프로비저닝 사용 중지 및 구성 정보 삭제하기
구성 정보를 유지하면서 앱의 자동 프로비저닝을 사용 중지하거나, 자동 프로비저닝을 사용 중지하고 모든 구성 정보를 삭제할 수 있습니다.
자동 프로비저닝 사용 중지
앱의 자동 프로비저닝을 사용 중지하고 구성 정보를 유지하려면 다음 안내를 따르세요.
-
Google 관리 콘솔에서 메뉴
앱
웹 및 모바일 앱으로 이동합니다.
이 작업을 수행하려면 최고 관리자로 로그인해야 합니다.
- SAML 앱의 이름을 클릭합니다.
- 옵션을 선택합니다.
- 자동 프로비저닝을 사용 중지합니다.
- 자동 프로비저닝
상태
사용 중지를 클릭합니다.
- 사용 중지를 클릭하여 확인하세요.
자동 프로비저닝 사용 중지 및 구성 정보 삭제하기
자동 프로비저닝을 사용 중지하고 모든 구성 정보를 삭제하려면 다음 안내를 따르세요.
-
Google 관리 콘솔에서 메뉴
앱
웹 및 모바일 앱으로 이동합니다.
이 작업을 수행하려면 최고 관리자로 로그인해야 합니다.
- SAML 앱 이름을 클릭합니다.
- 자동 프로비저닝을 클릭합니다.
- 삭제를 클릭하여 자동 프로비저닝을 사용 중지하고 모든 구성 정보를 삭제합니다.
기존 사용자는 삭제되지 않으며 계속 앱을 사용할 수 있습니다.
사용 정보 검토하기
- 자동 프로비저닝을 사용 설정한 후 사용 정보를 검토할 수 있습니다. 자세한 내용은 자동 사용자 프로비저닝 모니터링하기를 참고하세요.
- 지난 30일 동안의 다음 사용 정보를 검토할 수 있습니다.
| 관리자 로그 이벤트 | 설명 |
|---|---|
| 자동 프로비저닝으로 사용자 생성 | 자동 프로비저닝으로 사용자가 생성됨 |
| 자동 프로비저닝된 사용자 업데이트 | 자동 프로비저닝으로 사용자가 업데이트됨 |
| 자동 프로비저닝된 사용자 정지 | 자동 프로비저닝으로 사용자가 정지됨 |
| 자동 프로비저닝된 사용자 정지 해제 | 자동 프로비저닝으로 재활성화된 사용자 |
| 자동 프로비저닝된 사용자 하드 삭제 | 자동 프로비저닝으로 삭제된 사용자 |
| 오류 | 실패한 요청 |
자동 프로비저닝이 작동하지 않는 경우
Google에서 더 이상 앱에 연결할 수 없는 경우 자동 프로비저닝이 작동하지 않습니다. 예를 들어 Bearer 토큰이 만료되었거나 취소되었거나 앱의 SCIM URL이 변경되었을 수 있습니다. 이 문제를 해결하려면 토큰 또는 URL을 업데이트하세요.
-
Google 관리 콘솔에서 메뉴
앱
웹 및 모바일 앱으로 이동합니다.
이 작업을 수행하려면 최고 관리자로 로그인해야 합니다.
- SAML 앱의 이름을 클릭합니다.
- 자동 프로비저닝을 클릭합니다.
- Bearer 토큰을 업데이트하려면 다음 안내를 따르세요.
- 앱 승인에서 재승인을 클릭합니다.
- 액세스 토큰에 앱의 새 Bearer 토큰을 붙여넣습니다.
- 재승인을 클릭합니다.
- SCIM 기준 URL을 업데이트하려면 엔드포인트 URL에서 수정을 클릭하고 새 URL을 입력한 다음 업데이트를 클릭합니다.
- (선택사항) 연결을 확인하려면 연결 테스트에서 테스트를 클릭합니다.
자동 프로비저닝이 작동하지 않는 다른 이유에 대한 자세한 내용은 앱 설명서를 참고하세요.