알림

Duet AI가 Google Workspace를 위한 Gemini로 바뀌었습니다. 자세히 알아보기

타사 도구를 사용한 빠른 대량 프로비저닝

이 도움말은 제한된 시간 내에 50,000개 이상의 사용자 계정을 프로비저닝해야 하는 IT 관리자를 대상으로 합니다.  

타사 솔루션을 사용하여 대규모 계정을 빠르게 프로비저닝할 수 있습니다. 예를 들어 다운로드 가능한 무료 오픈소스 Google Apps Manager(GAM)는 Admin SDK Directory API를 사용하여 Google Workspace 사용자와 그룹을 만들고 관리합니다.

GAM은 다른 계정 기능 및 리소스를 관리하는 데 사용할 수 있는 여러 Google API와 상호작용합니다. 타사와의 통합에 대한 자세한 내용은 Google Cloud의 문제 해결의 튜토리얼 페이지를 참고하세요.

중요: Google Cloud 지원팀에서는 GAM 또는 기타 타사 솔루션은 지원하지 않지만 이러한 도구에서 사용되는 Admin SDK Directory API는 지원합니다. GAM에는 GAM의 사용, 복제, 배포에 대한 이용약관을 제공하는 Apache 2.0 라이선스가 적용됩니다.

시작하기 전에

대규모로 계정을 프로비저닝하려면 다음 사항이 필요합니다. 

  • 명령줄 프롬프트를 사용할 줄 알아야 합니다.
  • 다음과 같은 유료 Google Workspace 계정이 있어야 합니다. 

1단계: 계정 중복 방지하기

일부 사용자에게는 개인 Google 계정(예: Gmail 주소)이 있을 수 있습니다. 새로운 관리 Google Workspace 또는 Cloud ID 계정을 프로비저닝할 때 이러한 계정으로 인해 중복이 발생할 수 있습니다. 이러한 문제를 방지하려면 다음 안내를 참고하세요.

  1. 중복 계정 정보를 참고하세요.
  2. 기존 계정을 찾아 관리하는 방법을 알아보세요.

2단계: 단순하고 간략한 조직 구조 만들기

여러 수준으로 구성된 복잡한 조직 단위 계층 구조를 만들지 마세요. 나중에 계층 구조를 수정하고 사용자를 이동할 수 있습니다. 다음은 단순한 조직 구조를 설정하기 위한 몇 가지 도움말입니다.

  • 관리 중인 사용자가 액세스해야 하는 서비스 및 기능에 중점을 두세요.
  • 최상위 조직 단위에서 서비스 및 기능 사용을 제한하여 하위 조직 단위에 대한 액세스 권한을 부여합니다.

조직 구조의 작동 방식에 대해 자세히 알아보세요.

교육 예

아래 표에서 왼쪽의 구조는 조직의 실제 구조를 보여줍니다. 예를 들어 학교의 여러 조직 단위에 고급 Google Meet 기능에 대한 액세스 권한을 교사에게 반복적으로 부여해야 하는 경우 처음에는 이 구조를 관리하기 어려울 수 있습니다. 

제안된 구조는 기능에 중점을 둡니다. 관리자는 /학생 조직 단위의 모든 학생에 대해 서비스 및 기능을 쉽게 사용 중지할 수 있습니다. 예를 들어 셀프 비밀번호 복구를 사용 중지하고 YouTube 제한사항을 적용할 수 있습니다. 교사 및 다른 직원을 위한 고급 기능(예: Meet 스트리밍 및 녹화, 2단계 인증 등)을 사용 설정할 수도 있습니다.

조직 구조 예 권장되는 조직 구조

/School 1/Staff/Teachers

/School 1/Students/Year 2020/Class A

/School 1/Students/Year 2020/...

/School 2/Staff/Teachers

/School 2/Students/Year 2020/Class C

/School 2/Students/Year 2020/...

/ (root OrgUnit)

/Students

/Staff/IT

/Staff/Teachers

대규모 조직의 예

먼저 사용자에게 필요한 서비스와 기능을 결정한 후 다음 안내를 따르세요.

  1. 최상위 조직 단위에 이러한 설정을 적용합니다.
    이러한 설정을 재정의하지 않는 한 하위 조직 단위에 설정이 상속됩니다. 예:
  2. 보안을 강화하기 위해 부서에 2단계 인증을 사용하도록 요청합니다.
조직 구조 예 권장되는 조직 구조

/

/Sales

/IT

/Legal

/(최상위 조직 단위)

/2SV-Enforced(IT 및 법률)

/2SV(및 외부 공유 허용)

3단계: 데이터 소스 준비하기

사용자 계정 생성을 진행하려면 필요한 데이터로 CSV(쉼표로 구분된 값) 파일을 만듭니다. 다음은 필수 입력란입니다. 

  • FirstName(이름)
  • LastName(성)
  • PrimaryEmail(기본 메일): 사용자가 로그인할 때 사용하는 이메일입니다.
  • Password(비밀번호): 8자(영문 기준) 이상이어야 합니다.
  • OrgUnit(조직 단위): 위의 권장사항을 고려하여 각 조직 단위에 사용자를 만듭니다.

    참고: 사용자를 최상위(루트) 조직 단위에 배치하려면 /(슬래시)를 입력합니다. 하위 조직 단위는 슬래시로 구분합니다(예: /Staff/Teachers).

교육 예

FirstName,LastName,PrimaryEmail,Password,OrgUnit

Jane,Doe,id12345678@students.example.com,Zee+HWdt,/Students

John,Smith,john.smith@example.com,X2Ae+pME,/Staff

대규모 조직의 예

FirstName,LastName,PrimaryEmail,Password,OrgUnit

Jane,Doe,jane.doe@example.co.uk,V8hmj/QE,/

John,Smith,john.smith@example.com,9/t0UHQ6,/Sales

4단계: GAM 설정하기

GAM을 사용하기로 결정한 경우 다음 추천 단계를 따르세요.

  1. GAM 버전 5.10 이상을 사용하는 경우 GAM을 처음으로 실행하기 전에 GAM과 동일한 폴더에 noshorturls.txt라는 파일을 만듭니다.
    이 기능을 사용하면 gam-shortn.appspot.com 단축 URL이 사용 중지됩니다.
  2. GAM 웹사이트에서 GAM을 다운로드합니다.
  3. 도구를 구성합니다.
  4. 설정 중에 'GAM에서 Google Workspace 사용자 데이터 및 설정을 관리하도록 승인할 것인지' 묻는 메시지가 표시되면 N(아니요)으로 응답하여 도메인 전체 위임을 건너뜁니다.

다음 명령어를 사용하면 GAM이 올바른 Google Workspace 계정과 연결되어 있는지 확인할 수 있습니다.

gam info domain

5단계: GAM에서 여러 사용자 만들기

GAM에서 쉼표로 구분된 값(CSV) 파일을 읽고 Admin SDK Directory API에 관련 요청을 보내 사용자를 만듭니다.

위의 3단계에 지정된 필드로 쉼표로 구분된 값(CSV) 파일을 만든 경우 다음 명령어를 사용해 CSV에 사용자를 만듭니다. 

gam csv users.csv gam create user ~PrimaryEmail firstname ~FirstName lastname ~LastName password ~Password org ~OrgUnit changepassword on

다음을 확인하세요.

  1. 사용자마다 비밀번호를 다르게 만듭니다. 
  2. 선택사항인 changepassword on 매개변수를 사용하여 사용자가 처음 로그인한 후 비밀번호를 변경하도록 강제 시행합니다.

대안: 데이터 소스에 일부 필드가 누락된 경우

데이터 소스에 각 사용자에 대한 성 및 이름과 비밀번호가 하나만 있는 경우 first.last@example.com 형식으로 사용자 이름을 만들 수 있습니다. Charlie Smith라는 사용자에게는 Charlie.Smith@example.com을 사용합니다. 

명령어는 다음과 같습니다.

gam csv users.csv gam create user ~~FirstName~~.~~LastName~~@example.com password ~Password changepassword on

이 방법은 다음과 같은 사용자 이름을 가정합니다. 

  • 동일한 이름의 사용자가 없습니다. 
  • 이름 및 성에 다음 사항이 포함되지 않아야 합니다. 
    • 공간
    • 기타 허용되지 않는 문자 

사용자 및 그룹 이름 가이드라인으로 이동합니다.

질문

모두 열기   |   모두 닫기

Google Cloud 지원팀에 문의하려면 어떻게 해야 하나요?

​Google Workspace​ 지원팀에 문의로 이동합니다. 

이 도움말의 콘텐츠에 관해 궁금한 점이 있으면 지원 케이스에 해당 정보를 포함하고 도움말을 연결하세요. Google의 지원에 도움이 되는 로그나 기타 세부정보를 공유하려면 이메일을 보내주세요.

Google Workspace for Education 신청 및 승인에 관한 정보는 어디에서 찾을 수 있나요?

Google Workspace for Education 관련 절차에 대한 자세한 내용은 다음으로 이동하세요. 

  • Google Workspace for Education 시작하기 
  • Google Workspace for Education FAQ
비영리단체용 G Suite에 관한 정보는 어디에서 찾을 수 있나요?
프로그램 혜택, 자격요건 가이드라인 등 자세한 내용은 Google 비영리단체 프로그램 고객센터를 참고하세요.
관리 콘솔 또는 내 관리자 계정에 액세스할 수 없습니다. 어떻게 해야 하나요?
로그인 페이지로 이동하여 사용자 이름을 입력하고 비밀번호 찾기를 클릭합니다. 
표시되는 안내를 따랐지만 액세스 권한을 복구할 수 없는 경우 Google Cloud 지원팀에 문의할 수 있는 옵션이 제공됩니다. 도메인 소유권을 증명하고 몇 가지 보안 질문에 답변해야 합니다.
내 도메인이 확인되었는지 어떻게 확인할 수 있나요?

Google Workspace 계정을 만들면 도메인 소유권을 확인하라는 메시지가 표시됩니다. 기억나지 않는 경우 관리 콘솔에 로그인하여 도메인 섹션으로 이동한 다음 도메인 관리를 클릭합니다. 

목록의 첫 번째 도메인이 기본 도메인입니다. 상태 열에는 도메인 확인이 필요한지 여부가 표시됩니다.

Google Cloud 지원팀에서 GAM과 관련된 질문에 대해 도움을 받을 수 있나요?

Google Cloud 지원팀에서는 이러한 타사 솔루션을 지원하지 않지만, 이러한 도구에서 사용하는 Admin SDK Directory API는 지원합니다. GAM 도구 자체에 대해 도움을 드릴 수는 없지만 기본 API, 특히 Admin SDK Directory API에서 오류가 반환되는 경우 Google에서 도와드리겠습니다. GAM 위키에서 GAM 명령어 및 기술에 대해 자세히 알아보세요. 

GAM과 관련하여 도움이 필요하신가요? GAM 토론 그룹에서 지원을 제공하는 Google Workspace 관리자 커뮤니티에 문의하세요.

Admin SDK Directory API에 문제가 있다고 생각되면 Google Cloud 지원팀에 다음 세부정보를 제공하세요.

  • 타사 솔루션에서 호출하는 HTTP 메서드 및 엔드포인트(예: POST /admin/directory/v1/users?fields=primaryEmail)
  • 응답 코드 및 메시지(예: 403: 권한이 승인되지 않아 이 리소스/API에 액세스할 수 없음: 금지됨)

  • 응답 HTTP 헤더 날짜(예: 날짜: 2020년 6월 22일 수요일 17:48:48 GMT)
  • 호출하는 항목: 사용자 이름, 서비스 계정 또는 Google Cloud 프로젝트 ID

이름, 비밀번호, 인증 요청 헤더, IP 주소, 맞춤 스키마 값 또는 기타 민감한 정보를 삭제합니다.

프로젝트의 할당량이 부족합니다. 어떻게 해야 하나요?

대부분의 고객은 기본 할당량으로 충분합니다. API 한도에 대한 자세한 내용은 Directory API: 한도 및 할당량을 참고하세요.

프로젝트의 할당량을 더 늘리려면 다음과 같이 Google Cloud Console의 할당량 섹션에서 요건을 참고하세요.

  1. Google Cloud 콘솔을 엽니다. 
  2. 상단에서 만든 프로젝트 GAM을 선택합니다. 
  3. 왼쪽에서 탐색 메뉴 + IAM 및 관리자 + 할당량을 클릭합니다. 
  4. 서비스에서 사용자 프로비저닝과 관련된 Admin SDK로 필터링합니다. 
  5. 추가 할당량을 요청할 항목을 선택합니다. 
  6. 상단에서 할당량 수정을 클릭합니다. 

GAM에서 만든 Google Cloud 프로젝트에서 결제를 사용 설정하려면 현재 프로젝트에서 결제를 사용 설정하는 방법을 참고하세요.

관련 주제

도움이 되었나요?

어떻게 하면 개선할 수 있을까요?
검색
검색어 지우기
검색 닫기
기본 메뉴
14429674983118455819
true
도움말 센터 검색
true
true
true
true
true
73010
false
false