로그인

Google 클래스룸 부가기능은 사용자를 식별하고 인증하기 위해 반드시 Google 싱글 사인온 (SSO)을 사용해야 합니다.

SSO에 대한 자세한 내용은 Google ID의 OpenID Connect 가이드를 참조하세요. 자동 로그인로그인 브랜드 가이드라인 관련 사용자 가입 및 로그인에 관한 Google의 공식 문서도 참고하세요.

클래스룸 부가기능의 Google SSO 구현 안내는 원활한 로그인 페이지를 참조하세요. 원활한 로그인 가이드에서는 부가기능이 로그인 권장사항을 따르는지 확인하는 데 사용할 수 있는 테스트 계획도 참고합니다.

로그인 흐름

사용자의 로그인 문제를 줄이기 위해 Google 클래스룸에서는 iframe이 열릴 때 login_hinthd의 두 가지 쿼리 매개변수를 제공합니다. hd는 사용자의 도메인이며 사용자가 부가기능을 처음 열 때 제공됩니다. login_hint는 사용자의 고유 Google ID로, 사용자가 부가기능에 처음으로 로그인한 후에 제공됩니다. 이 매개변수는 Google 클래스룸에 로그인한 사용자에 대한 컨텍스트를 제공합니다. 쿼리 매개변수에 대한 자세한 내용은 로그인 매개변수 가이드 페이지를 참조하세요.

로그인 대화상자가 표시되면 hd 쿼리 매개변수를 사용하여 계정 선택을 간소화하는 잘못된 도메인을 필터링합니다. 현재 Google 클래스룸 사용자의 login_hint 쿼리 매개변수가 로그인한 부가기능 사용자와 일치하지 않는 경우 Google 로그인 대화상자를 표시해야 합니다. 버튼은 Google의 브랜드 가이드라인을 준수해야 합니다. 사용자가 이미 로그인했다면 다시 로그인하라는 메시지가 표시되지 않습니다.

초기 SSO 흐름 그림 1. 사용자가 부가기능을 처음 실행할 때의 로그인 흐름

개별 설치의 경우 사용자 계정에 부가기능이 추가됩니다. 부가기능이 개별적으로 설치되면 사용자에게 부가기능 액세스 범위에 동의하라는 메시지가 표시됩니다.

관리자 설치는 도메인의 일부 또는 모든 계정에 부가기능을 추가하며 도메인 관리자만 수행할 수 있습니다. 관리자는 선택적으로 도메인의 모든 사용자를 대신하여 모든 액세스 범위에 동의할 수 있습니다. 관리자가 선택하는 경우 사용자에게 액세스 범위에 동의하라는 메시지가 표시되지 않습니다.

자세한 내용은 설치 설정을 참고하세요.