Looker는 LDAP, SAML 또는 Google OAuth와 같은 여러 인증 서버 유형 중 하나를 통해 사용자를 인증할 수 있습니다. 이러한 인증 방법을 사용하면 이메일/비밀번호와 같은 다른 인증 시스템이 사용 중지됩니다.
관리자는 사용자에게 관리자 역할 또는 login_special_email 권한이 있는 경우 사용자에게 이메일 주소를 사용하는 보조 로그인 옵션을 제공할 수 있습니다.
1단계: Looker 인스턴스에서 대체 로그인 사용 설정
먼저 이메일 사용자 인증 정보를 수락하도록 Looker 인스턴스를 구성해야 합니다. 이메일 사용자 인증 정보를 수락하도록 Looker를 구성하려면 다음 단계를 따르세요.
관리 패널의 인증 탭으로 이동하여 현재 사용 설정된 인증 유형을 선택합니다. LDAP, SAML, Google OAuth 등이 여기에 해당합니다.
이전 옵션 섹션에서 관리자 및 지정된 사용자를 위한 대체 로그인 스위치를 사용 설정합니다.
2단계: 사용자에게 대체 로그인 사용 권한 부여
관리자 역할 또는 login_special_email 권한이 있는 사용자만 대체 로그인을 사용할 수 있습니다. 관리자 외 사용자에게 login_special_email 권한을 부여하는 한 가지 방법은 다음과 같이 먼저 해당 권한이 포함된 새 역할을 만든 후 사용자에게 역할을 할당하는 것입니다.
관리자 패널의 사용자 탭 아래에 있는 역할 페이지로 이동합니다.
페이지 상단에서 새 권한 세트 버튼을 클릭합니다.
새 권한 세트의 이름을 입력합니다(예: '대체 로그인').
login_special_email 라벨이 지정된 체크박스를 선택합니다.
페이지 하단에서 저장 버튼을 클릭합니다.
페이지 상단에서 새 역할 버튼을 클릭합니다.
새 역할의 이름을 입력합니다(예: '대체 로그인 역할').
권한 세트 섹션의 권한 세트 목록에서 새 권한 세트를 선택합니다.
모델 세트 섹션에서 모두를 선택합니다.
사용자 섹션에서 대체 로그인 권한을 부여할 사용자를 선택합니다.
페이지 하단의 새 역할 버튼을 클릭하여 새 역할을 저장합니다.
팝업 대화상자에서 확인 버튼을 클릭합니다.
3단계: 사용자의 이메일 사용자 인증 정보 만들기
사용자가 이메일 사용자 인증 정보를 사용할 수 있도록 설정했으므로 이제 해당 이메일 사용자 인증 정보를 만들어야 합니다. Looker 관리자는 이러한 사용자 인증 정보를 만들기 위해 Looker API를 사용하여 POST 요청을 수행하거나 관리자가 선택한 프로그래밍 언어로 Looker API SDK를 사용할 수 있습니다.
옵션 1: Looker API에 POST 요청 보내기
이 방법은 수동적이므로 대체 로그인 옵션을 설정하려는 사용자 수가 제한되어 있을 때 사용하는 것이 좋습니다.
이 예시에서는 임시 액세스 토큰을 사용하여 create_user_credentials_email API 엔드포인트에 POST 요청을 수행하기 위해 curl 명령어를 사용합니다.
임시 토큰(ACCESS_TOKEN)을 생성하려면 SDK를 사용하지 않는 인증 섹션의 API 인증 문서 페이지에 있는 단계를 따르세요.
승인 헤더에 다음 임시 토큰을 사용하여 사용자의 user_id를 통해 Looker API에 POST 요청을 전송하고 요청 본문에 사용자의 이메일을 포함합니다.
재설정 링크 보내기 버튼을 클릭합니다. POST 요청에서 지정한 이메일 주소로 이메일이 전송됩니다.
대체 로그인 방법을 사용하려면 사용자가 Looker에 로그인할 때 대체 로그인 링크를 클릭한 후 이름과 이메일 주소를 입력해야 합니다. 인증 버튼을 통해 SAML, LDAP, OAuth 사용자 인증 정보를 사용하여 인증할 수 있습니다.
옵션 2: Looker API SDK 사용
Looker API에 직접 요청하는 수동 단계를 수행하는 대신 Looker에서 제공하는 SDK를 사용하여 원하는 프로그래밍 언어로 API와 상호작용할 수 있습니다. Looker API SDK를 가져오고 클라이언트 연결을 설정한 후에는 다음 단계를 따르세요.
create_user_credentials_email(user_id, body) 함수를 사용하여 Looker API 문서에 지정된 대로 user_id 및 body를 삽입합니다. Looker API로 사용자를 자동 프로비저닝하는 것에 관한 이 Looker 커뮤니티 게시물에서 유사한 예시를 따를 수 있습니다.
SDK 메서드를 사용하여 사용자 계정을 업데이트한 후 관리자 섹션의 사용자 페이지에서 사용자 계정을 찾아 수정을 클릭합니다.
재설정 링크 보내기 버튼을 클릭합니다. POST 요청에서 지정한 이메일 주소로 이메일이 전송됩니다.
대체 로그인 방법을 사용하려면 사용자가 Looker에 로그인할 때 대체 로그인 링크를 클릭한 후 이름과 이메일 주소를 입력해야 합니다. 인증 버튼을 통해 SAML, LDAP, OAuth 사용자 인증 정보를 사용하여 인증할 수 있습니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2024-12-22(UTC)"],[],[],null,["# Enabling the alternate login option\n\nLooker can authenticate users through one of several authentication server types, such as [LDAP](/looker/docs/admin-panel-authentication-ldap), [SAML](/looker/docs/admin-panel-authentication-saml), or [Google OAuth](/looker/docs/admin-panel-authentication-google). Enabling any of these authentication methods will disable other authentication systems, such as email/password.\n\n\nAdmins can give users an alternate login option that uses their email address if the user or users have either an Admin role or [`login_special_email`](/looker/docs/admin-panel-authentication-saml#alternate_login_for_admins_and_specified_users) permissions.\n\nStep 1: Enable alternate login on the Looker instance\n-----------------------------------------------------\n\n\nFirst, the Looker instance must be configured to accept email credentials. To configure Looker to accept email credentials, follow these steps:\n\n1. Navigate to the **Authentication** tab of the **Admin** panel, and select the currently enabled authentication type. Some examples include **LDAP** , **SAML** , and **Google OAuth**.\n2. Enable the **Alternate login for admins and specified users** switch in the **Migration Options** section.\n\nStep 2: Grant the user permission to use alternate login\n--------------------------------------------------------\n\n\nOnly users with the Admin role or with the `login_special_email` permission may use alternate login. One way to grant the `login_special_email` permission to a non-admin user is to first create a new role containing that permission and then assign that role to the user, as follows:\n\n1. Navigate to the **Roles** page, located under the **Users** tab of the **Admin** panel.\n2. Click the **New Permission Set** button at the top of the page.\n3. Enter a name for the new permission set, for example, \"Alternate Login\".\n4. Check the box labeled `login_special_email`.\n5. Click the **Save** button at the bottom of the page.\n6. Click the **New Role** button at the top of the page.\n7. Enter a name for the new role, for example, \"Alternate Login Role\".\n8. Under the **Permission Set** section, select your new permission set from the list of permission sets.\n9. Under the **Model Set** section, select **All**.\n10. Under the **Users** section, select the user that should be granted the alternate login permission.\n11. Click the **New Role** button at the bottom of the page to save the new role.\n12. Click the **Confirm** button in the pop-up dialog box.\n\nStep 3: Creating email credentials for the user\n-----------------------------------------------\n\n\nNow that the user has been enabled to use email credentials, those email credentials must be created. To create these credentials, a Looker admin can either use the Looker API to make a POST request or use the Looker API SDK in the programming language of the admin's choice.\n\n### Option 1: Making a POST request to the Looker API\n\n\nBecause of its manual nature, this is a better method to use when you have a limited number of users for whom you want to set up the alternate login option.\n\n\nThis example uses a curl command to make a POST request to the `create_user_credentials_email` API endpoint using a temporary access token:\n\n1. To generate the temporary token (`ACCESS_TOKEN`), follow the steps on the [API Authentication](/looker/docs/api-auth#authentication_without_a_sdk) documentation page in the **Authentication without a SDK** section.\n2. Using this temporary token in the authorization header, send a POST request to the Looker API using the user's `user_id`, and include their email in the body of the request. \n\n ```\n curl -H \"Authorization: token ACCESS_TOKEN\" -H 'Content-Type: application/json' -X POST -d '{ \"email\": \"example_name@example_email.com\" }' https://\u003cinstance_name\u003c.api.looker.com/api/3.1/users/{user_id}/credentials_email\n ```\n3. On the **Users** page of the **Admin** section, find the user account and click **Edit**.\n4. Click the **Send reset link** button. This will send an email to the email address you specified in your POST request.\n\n\nTo use the alternate login method, when the user logs in to Looker they will need to click the **Alternate Login** link and then enter their name and email address. They can still authenticate by using their SAML, LDAP, or OAuth credentials through the **Authenticate** button.\n\n### Option 2: Using the Looker API SDK\n\n\nRather than going through the manual steps of making requests directly to the Looker API, you can instead use a Looker-provided SDK to interact with the API in a programming language of your choice. After you have imported the Looker API SDK and established a client connection, follow these steps:\n\n1. Use the `create_user_credentials_email(user_id, body)` function, inserting the `user_id` and `body` as specified in the [Looker API documentation](/looker/docs/reference/looker-api/latest/methods/User/create_user_credentials_email). You can follow a similar example from this Looker Community post about [automatically provisioning users with the Looker API](https://community.looker.com/open-source-projects-78/automatically-provisioning-users-with-the-looker-api-12016).\n2. Once the user accounts have been updated using the SDK method, on the **Users** page of the **Admin** section, find the user account and click **Edit**.\n3. Click the **Send reset link** button. This will send an email to the email address you specified in your POST request.\n\n\nTo use the alternate login method, when the user logs in to Looker, they will need to click the **Alternate Login** link and then enter their name and email address. They can still authenticate by using their SAML, LDAP, or OAuth credentials through the **Authenticate** button."]]
