맞춤 SCIM 프로필로 자동 사용자 프로비저닝 설정하기 (베타)

커스텀 SCIM 프로필을 사용한 자동 사용자 프로비저닝은 제한된 수의 참여자만 사용할 수 있는 베타 기능입니다. 앱의 세부정보 페이지에 자동 프로비저닝이 표시되지 않으면 아직 조직에서 사용할 수 없는 것입니다.

맞춤 SCIM 프로필을 사용한 자동 사용자 프로비저닝을 통해 SCIM 2.0을 지원하는 맞춤 또는 사전 통합된 SAML 앱에서 사용자 계정을 자동으로 설정하고 관리할 수 있습니다.

시작하기 전에

맞춤 SCIM 프로필을 설정하려면 다음이 필요합니다.

  • 최고 관리자 역할이 있는 Cloud ID 계정 자세한 내용은 기본 제공 관리자 역할을 참고하세요.
  • 관리 콘솔에서 사용자를 위해 설정되고 사용 설정된 맞춤 또는 사전 통합 SAML 앱

앱에 다음을 수행하는 SCIM 서버가 있어야 합니다.

  • SCIM 버전 2.0 지원
  • POST, GET, PATCH(PUT로 대체), DELETE를 포함한 표준 HTTP 메서드를 사용합니다.
  • Bearer 토큰 인증을 지원합니다. OAuth 토큰 인증은 지원되지 않습니다.

커스텀 SCIM 프로필로 자동 사용자 프로비저닝 설정하기

  1. Google 관리 콘솔에서 메뉴 다음 앱 다음 웹 및 모바일 앱으로 이동합니다.

    이 작업을 수행하려면 최고 관리자로 로그인해야 합니다.

  2. SAML 앱의 이름을 클릭합니다.
  3. 자동 프로비저닝에서 자동 프로비저닝 구성을 클릭합니다.
  4. 액세스 토큰에 앱의 Bearer 토큰을 입력한 다음 계속을 클릭합니다.
  5. 엔드포인트 URL 입력란에 앱의 SCIM 엔드포인트 URL을 입력한 다음 계속을 클릭합니다. Google은 SCIM 엔드포인트에 연결하여 지원되는 속성을 자동으로 검색합니다.
  6. Google 디렉터리 속성을 해당 앱 속성에 매핑합니다. 앱에서 스키마 검색을 지원하는 경우 테이블에 검색된 속성이 자동 입력됩니다. 맞춤 속성을 수동으로 매핑하려면 매핑 추가를 클릭하고 완료되면 다음 계속을 클릭합니다.
  7. (선택사항) 그룹을 추가하지 않으면 SAML 앱에 액세스할 수 있는 모든 사용자가 프로비저닝됩니다. 자동 프로비저닝을 특정 사용자 그룹으로 제한하려면 다음 안내를 따릅니다.
    • 그룹 검색의 경우 그룹 이름의 글자를 하나 이상 입력하고 그룹 이름을 선택한 다음 범위를 선택합니다.
    • 그룹을 더 추가합니다.
    • (선택사항) 그룹을 삭제하려면 삭제를 클릭합니다.
      그룹에 보조 도메인이나 조직 외부의 사용자가 있는 경우 해당 사용자는 프로비저닝되지 않습니다.
  8. 사용자를 대상으로 앱이 사용 중지되거나 사용자의 Google Workspace 계정이 정지 또는 삭제된 후 해당 사용자가 앱에 액세스할 수 있는 기간을 결정합니다. 계정을 정지하거나, 계정을 하드 삭제하거나, 계정을 정지한 후 하드 삭제할 수 있습니다. 각 작업에 대해 지연 기간을 개별적으로 설정할 수 있습니다.
    1. 필요에 따라 각 이벤트의 옵션을 선택합니다.
      • 사용자에 대해 앱이 사용 중지된 경우
      • Google에서 사용자가 정지된 경우
      • Google에서 사용자가 삭제되는 경우
        사용자 계정을 정지하면 비활성화된 것으로 표시됩니다. 사용자 계정을 하드 삭제하면 앱에서 영구적으로 삭제됩니다. 사용자 계정을 하드 삭제하는 데 걸리는 시간을 항상 더 길게 설정하세요. 정지 및 삭제에 관한 자세한 내용은 프로비저닝 해제 기간 수정하기를 참고하세요.
    2. 계속을 클릭합니다.
  9. 연결을 테스트합니다.

    1. Google 디렉터리 사용자에서 앱에 계정이 없는 사용자를 검색하여 선택합니다.
    2. 테스트를 클릭합니다.

      Google에서 앱에 사용자의 계정을 만들고 업데이트한 후 삭제합니다. 각 작업에는 성공, 실패 또는 실행되지 않음이 표시됩니다. 실패한 작업의 경우 앱에서 HTTP 코드, SCIM 오류 유형, 원시 응답 보기 세부정보를 검토합니다.

      참고: 예를 들어 사용자가 이미 존재하여 앱이 신규 사용자에 대해 201 Created를 반환하지 않으면 사용자 만들기가 실패하고 Google은 업데이트 및 삭제 작업을 건너뜁니다. 사용자 삭제가 실패하면 앱에서 테스트 계정을 수동으로 삭제합니다.

  10. 마침을 클릭합니다.
    테스트에 실패하더라도 완료를 클릭하고 나중에 다시 테스트할 수 있습니다. 이 단계에서는 구성을 저장하지만 자동 프로비저닝을 사용 설정하지는 않습니다. 사용 설정하려면 앱의 세부정보 페이지 다음 자동 프로비저닝으로 이동하여 전환 버튼을 활성으로 설정합니다.
    참고: 사용자에 대해 앱이 사용 설정되지 않은 경우 이 설정은 사용 중지됩니다. 사용자 액세스를 클릭하고 앱을 사용 설정하여 자동 프로비저닝을 사용 설정합니다.

프로비저닝 정보 수정하기

자동 프로비저닝이 적용되는 사용자 그룹 수정하기

  1. Google 관리 콘솔에서 메뉴 다음 앱 다음 웹 및 모바일 앱으로 이동합니다.

    이 작업을 수행하려면 최고 관리자로 로그인해야 합니다.

  2. SAML 앱의 이름을 클릭합니다.
  3. 자동 프로비저닝을 클릭합니다.
  4. 프로비저닝 범위에서 수정을 클릭합니다.
  5. 그룹 검색의 경우 그룹 이름의 글자를 하나 이상 입력하고 그룹 이름을 선택한 다음 범위를 선택합니다.
  6. 그룹을 더 추가합니다.
  7. (선택사항) 그룹을 삭제하려면 삭제를 클릭합니다.
    그룹에 보조 도메인이나 조직 외부의 사용자가 있는 경우 해당 사용자는 프로비저닝되지 않습니다.
  8. 업데이트를 클릭합니다.

프로비저닝 해제 기간 수정하기

얼마 후 프로비저닝 해제 작업이 시작될 지 정의하려면 다음 안내를 따르세요.

  1. Google 관리 콘솔에서 메뉴 다음 앱 다음 웹 및 모바일 앱으로 이동합니다.

    이 작업을 수행하려면 최고 관리자로 로그인해야 합니다.

  2. SAML 앱의 이름을 클릭합니다.
  3. 자동 프로비저닝을 클릭합니다.
  4. 프로비저닝 해제에서 수정을 클릭합니다.
  5. 각 이벤트 (사용자에게 앱이 사용 중지된 경우, 사용자가 Google에서 정지된 경우, 사용자가 Google에서 삭제된 경우)에 대해 수행할 작업과 변경사항이 발생한 후 Google에서 앱에 요청을 보내기 전에 대기하는 시간 (24시간 이내 또는 1, 7, 21일 후)을 선택합니다.
    • 사용자 계정 정지: 앱에서 사용자를 비활성화합니다 (PATCH 또는 active: false를 사용하는 PUT).
    • 사용자 계정 하드 삭제: 앱 (DELETE /Users/{id})에서 사용자를 영구적으로 삭제합니다.
      두 옵션을 모두 선택하는 경우 항상 하드 삭제의 지연 시간을 정지보다 길게 설정하세요.
  6. 업데이트를 클릭합니다.

자동 프로비저닝 사용 중지 및 구성 정보 삭제하기

구성 정보를 유지하면서 앱의 자동 프로비저닝을 사용 중지하거나, 자동 프로비저닝을 사용 중지하고 모든 구성 정보를 삭제할 수 있습니다.

자동 프로비저닝 사용 중지

앱의 자동 프로비저닝을 사용 중지하고 구성 정보를 유지하려면 다음 안내를 따르세요.

  1. Google 관리 콘솔에서 메뉴 다음 앱 다음 웹 및 모바일 앱으로 이동합니다.

    이 작업을 수행하려면 최고 관리자로 로그인해야 합니다.

  2. SAML 앱의 이름을 클릭합니다.
  3. 옵션을 선택합니다.
    • 자동 프로비저닝을 사용 중지합니다.
    • 자동 프로비저닝 다음 상태 다음 사용 중지를 클릭합니다.
  4. 사용 중지를 클릭하여 확인하세요.

자동 프로비저닝 사용 중지 및 구성 정보 삭제하기

자동 프로비저닝을 사용 중지하고 모든 구성 정보를 삭제하려면 다음 안내를 따르세요.

  1. Google 관리 콘솔에서 메뉴 다음 앱 다음 웹 및 모바일 앱으로 이동합니다.

    이 작업을 수행하려면 최고 관리자로 로그인해야 합니다.

  2. SAML 앱 이름을 클릭합니다.
  3. 자동 프로비저닝을 클릭합니다.
  4. 삭제를 클릭하여 자동 프로비저닝을 사용 중지하고 모든 구성 정보를 삭제합니다.
    기존 사용자는 삭제되지 않으며 계속 앱을 사용할 수 있습니다.

사용 정보 검토하기

  • 자동 프로비저닝을 사용 설정한 후 사용 정보를 검토할 수 있습니다. 자세한 내용은 자동 사용자 프로비저닝 모니터링하기를 참고하세요.
  • 지난 30일 동안의 다음 사용 정보를 검토할 수 있습니다.
관리자 로그 이벤트 설명
자동 프로비저닝으로 사용자 생성 자동 프로비저닝으로 사용자가 생성됨
자동 프로비저닝된 사용자 업데이트 자동 프로비저닝으로 사용자가 업데이트됨
자동 프로비저닝된 사용자 정지 자동 프로비저닝으로 사용자가 정지됨
자동 프로비저닝된 사용자 정지 해제 자동 프로비저닝으로 재활성화된 사용자
자동 프로비저닝된 사용자 하드 삭제 자동 프로비저닝으로 삭제된 사용자
오류 실패한 요청

자동 프로비저닝이 작동하지 않는 경우

Google에서 더 이상 앱에 연결할 수 없는 경우 자동 프로비저닝이 작동하지 않습니다. 예를 들어 Bearer 토큰이 만료되었거나 취소되었거나 앱의 SCIM URL이 변경되었을 수 있습니다. 이 문제를 해결하려면 토큰 또는 URL을 업데이트하세요.

  1. Google 관리 콘솔에서 메뉴 다음 앱 다음 웹 및 모바일 앱으로 이동합니다.

    이 작업을 수행하려면 최고 관리자로 로그인해야 합니다.

  2. SAML 앱의 이름을 클릭합니다.
  3. 자동 프로비저닝을 클릭합니다.
  4. Bearer 토큰을 업데이트하려면 다음 안내를 따르세요.
    1. 앱 승인에서 재승인을 클릭합니다.
    2. 액세스 토큰에 앱의 새 Bearer 토큰을 붙여넣습니다.
    3. 재승인을 클릭합니다.
  5. SCIM 기준 URL을 업데이트하려면 엔드포인트 URL에서 수정을 클릭하고 새 URL을 입력한 다음 업데이트를 클릭합니다.
  6. (선택사항) 연결을 확인하려면 연결 테스트에서 테스트를 클릭합니다.

자동 프로비저닝이 작동하지 않는 다른 이유에 대한 자세한 내용은 앱 설명서를 참고하세요.