Google Workspace를 설정할 때 Google Workspace API가 올바르게 작동하도록 호스트 이름을 허용 목록에 추가해야 합니다.
중요:
- 이 정보는 예고 없이 변경될 수 있습니다.
- API에 대한 제품별 정보는 해당 제품의 고객센터 콘텐츠를 참고하세요.
1단계: 연결 포트 열기
다음 포트를 엽니다.
| 포트 | 용도 |
|---|---|
| TCP 포트 443(HTTPS) | 인증 및 API 호출을 위한 기본 URL 액세스 |
| TCP 포트 80(HTTP) | CRL 및 OCSP 검사 허용(아래 4단계) |
참고:
- 설정과 애플리케이션에 따라 규칙을 추가로 허용해야 할 수도 있습니다.
- Microsoft Windows 클라이언트를 사용하는 경우 애플리케이션별로 이러한 규칙을 허용해야 할 수도 있습니다. 자세한 내용은 Microsoft 설명서를 참고하세요.
2단계: 허용 URL
새로운 기능- 2023년 1월 17일: Google Workspace for Education 서비스 내에 삽입된 YouTube 동영상을 위한 URL이 추가되었습니다.
이 기능은 롤백되었습니다. www.youtubeeducation.com을 포함하도록 허용 목록 또는 차단 목록을 업데이트한 경우 조직이 Google Workspace for Education 서비스(예: 클래스룸 및 Slides) 내에서 YouTube 동영상을 사용하는 방식을 유지하려면 www.youtube.com으로 되돌려야 합니다.
- May 2, 2022—Added URLs for Google Chat
- 2021년 3월 31일: Google Meet에 허용되는 URL이 추가되고 Google 주소록이 지원 중단으로 표시되었습니다.
Google Workspace API에 대해서는 다음 URL을 허용합니다.
| 용도 | URL |
|---|---|
| 인증
자세한 내용은 웹 서버 애플리케이션용 OAuth 2.0 사용을 참고하세요. |
https://accounts.google.com/o/oauth2 https://www.googleapis.com/oauth2 https://oauth2.googleapis.com/token |
| 기본 API 시작점 | https://*.googleapis.com
(*는 마침표를 포함하지 않는 문자열) |
| 이메일 | 기본 API 시작점 외의 사용 가능한 주소: https://mail.google.com/mail |
| 연락처 및 전체 주소록(GAL) | https://www.google.com/m8 |
| Google Workspace Admin Settings API | https://apps-apis.google.com/a |
| 계정 및 로그인 | https://www.google.com/accounts/ClientLogin https://www.google.com/accounts/ |
도움말: HTTP 상태 코드(204)를 확인하는 데 필요한 https://www.googleapis.com/generate_204를 허용할 수도 있습니다.
추가 제어를 위해 다음 URL을 허용할 수도 있습니다.
| 용도 | URL |
|---|---|
| 추가 인증 URL
설정에 따라 이러한 URL이 모두 필요하지는 않을 수도 있습니다. |
https://accounts.google.com/o/oauth2/auth https://accounts.google.com/o/oauth2/token https://accounts.google.com/o/oauth2/v2/auth https://oauth2.googleapis.com/token https://www.googleapis.com/oauth2/v3/token https://www.googleapis.com/oauth2/v4/token https://www.googleapis.com/oauth2/v2/tokeninfo https://www.googleapis.com/oauth2/v3/tokeninfo https://accounts.google.com/o/oauth2/revoke https://accounts.youtube.com https://www.google.com https://fonts.gstatic.com https://ssl.gstatic.com https://www.gstatic.com https://*.googleusercontent.com/* |
| Gmail |
https://mail.google.com/mail https://www.googleapis.com/gmail https://www.googleapis.com/upload/gmail |
| Google Calendar API | https://www.googleapis.com/calendar |
| Google Chat | https://chat.google.com https://mail.google.com/chat |
| Google Classroom API | https://classroom.googleapis.com |
| Google Contacts API
(지원 중단됨. People API 권장) |
https://www.google.com/m8/feeds |
| 전체 주소록(GAL)
Google Workspace Admin SDK |
https://www.google.com/m8/feeds/gal |
| Google Drive API | https://www.googleapis.com/drive https://www.googleapis.com/upload/drive |
| Google Drive Activity API | https://www.googleapis.com/appsactivity |
| Google Meet | https://*.googlevideo.com/* https://*.youtube-nocookie.com/* https://*.ytimg.com/* |
| Google Sheets API | https://sheets.googleapis.com |
| Google Slides API | https://slides.googleapis.com |
| Google Tasks API | https://www.googleapis.com/tasks |
| Google Workspace Admin SDK |
https://www.googleapis.com/admin/datatransfer |
| Google Workspace Admin SDK |
https://www.googleapis.com/admin/directory |
| Google Workspace Admin SDK |
https://www.googleapis.com/apps/licensing |
| Google Workspace Admin SDK |
https://www.googleapis.com/upload/groups |
| Google Workspace Admin SDK |
https://www.googleapis.com/groups |
| Google Workspace Admin SDK |
https://www.googleapis.com/admin/reports |
| People API | https://people.googleapis.com |
| Google Workspace for Education 서비스 내에 삽입된 YouTube 동영상 | https://www.youtubeeducation.com |
Education 관리자용 참고사항: Google Workspace for Education 서비스에 삽입된 YouTube 동영상의 URL은 Google Workspace for Education 관리자에게만 해당됩니다. 서드 파티 서비스를 사용하여 특정 도메인을 허용하거나 차단하는 경우에는 www.youtubeeducation.com을 허용 목록 또는 차단 목록에 추가하기만 하면 됩니다.
3단계: Google IP 주소 범위 검토하기
Google IP 주소 범위를 찾는 방법을 검토하세요. 2단계에 명시된 모든 Google URL에 Google IP 주소를 사용할 수 있습니다.
Google 관리 콘솔 도구 상자에서 연결을 테스트할 수도 있습니다.
4단계: 검사 허용하기
CRL 검사해지 인증서 목록(CRL)은 인증서를 발급한 인증 기관(CA)에서 만료일 전에 취소한 디지털 인증서의 목록입니다. 이러한 인증서는 신뢰할 수 없습니다.
CRL은 보통 CA 웹사이트의 HTTP(HTTPS가 아님) URL을 통해 전송됩니다. CRL 배포 지점은 인증서 X509v3의 세부정보에 표시됩니다.
다음은 현재 Google 서비스에서 사용 중인 CRL 배포 지점입니다.
- http://crl.pki.goog
- http://crls.pki.goog
자세한 내용은 Google Trust Services를 참고하세요.
온라인 인증서 상태 프로토콜(OCSP)은 X.509 디지털 인증서의 취소 상태를 가져오는 데 사용되는 인터넷 프로토콜입니다.
Google 서비스에서 사용 중인 현재 OCSP 배포 지점: http://ocsp.pki.goog
관련 주제
Google, Google Workspace 및 관련 마크와 로고는 Google LLC의 상표입니다. 기타 모든 회사명 및 제품명은 해당 업체의 상표입니다.
