클래스룸 부가기능에서 Google SSO를 구현하는 방법에 관한 안내는 원활한 로그인 페이지를 참고하세요. 원활한 로그인 가이드에서는 부가기능이 로그인 권장사항을 따르는지 확인하는 데 사용할 수 있는 테스트 계획도 참고합니다.
로그인 흐름
사용자의 로그인 마찰을 줄이기 위해 Google 클래스룸은 iframe이 열릴 때 login_hint 쿼리 매개변수를 제공합니다. login_hint는 사용자의 고유한 Google ID이며, 사용자가 부가기능에 처음 로그인한 후에 제공됩니다. 이 매개변수는 Google 클래스룸에 로그인한 사용자에 관한 컨텍스트를 제공합니다. 이러한 쿼리 매개변수에 대한 자세한 내용은 로그인 매개변수 가이드 페이지를 참고하세요.
현재 Google 클래스룸 사용자의 login_hint 쿼리 매개변수가 부가기능의 로그인한 사용자와 일치하지 않으면 Google 로그인 대화상자를 표시해야 합니다. 버튼은 Google 브랜드 가이드라인을 준수해야 합니다. 사용자가 이미 로그인한 경우 다시 로그인하라는 메시지가 표시되지 않아야 합니다.
[null,null,["최종 업데이트: 2025-08-29(UTC)"],[],[],null,["# Sign in\n\nGoogle Classroom add-ons **must** use Google single sign-on (SSO) to identify\nand authenticate users.\n\nSee [Google Identity's OpenID Connect Guide](https://developers.google.com/identity/protocols/oauth2/openid-connect) for more information on SSO. We\nalso recommend referencing Google's official documentation on user sign-up and\nsign-in for [automatic sign in](https://developers.google.com/identity/gsi/web) and [Sign-In Branding Guidelines](https://developers.google.com/identity/branding-guidelines).\n\nSee the [frictionless sign-in page](/workspace/classroom/add-ons/developer-guides/frictionless-signin) for implementation guidance for Google SSO\nin Classroom add-ons. The frictionless sign-in guide also refers\nto the [test plan](/static/workspace/classroom/assets/classroom_add_ons_test_plan.pdf) that can be used to ensure your add-on is\nfollowing sign-in best practices.\n\nSign in flow\n------------\n\nTo reduce sign-in friction for users, Google Classroom provides the\n`login_hint` query parameter when an iframe is opened. `login_hint` is a user's\nunique Google ID, and is provided *after* the user has signed into your add-on\nfor the first time. This parameter provides context on the user that's signed\ninto Google Classroom. See our [sign-in parameters guide page](/workspace/classroom/add-ons/developer-guides/iframes#sign-in_related_parameters) for a more\ndetailed discussion of these query parameters.\n\nYou must display a Google sign-in dialog if the `login_hint` query parameter of\nthe current Google Classroom user doesn't match any signed-in user of the\nadd-on. The button must adhere to [Google's branding guidelines](https://developers.google.com/identity/branding-guidelines). If the user is\nalready signed in, they shouldn't be prompted to sign-in again.\n\n**Figure 1.** Sign in flow when a user initially launches\nyour add-on.\n| **Important:** The sign in button should only be seen when the add-on doesn't have a signed in user to compare against the `login_hint` query parameter. The sign in button is unnecessary if the add-on matches the signed in user using the value of `login_hint`; in this case, the add-on should keep the user signed in."]]
그림 1. 사용자가 처음 부가기능을 실행할 때의 로그인 흐름