OAuth/OpenID 연결을 사용한 Drupal Azure AD B2C SSO 통합

회사 개요

Drupal OAuth 클라이언트 모듈을 사용하면 싱글 사인온 즉, OAuth 또는 OpenID 연결 프로토콜을 사용하는 모든 ID 공급자가 있는 Drupal 사이트의 SSO입니다. 여기서는 Azure AD B2C로 모듈을 구성하는 단계를 살펴보겠습니다. 이 구성이 완료되면 사용자는 Azure B2C 자격 증명을 사용하여 Drupal 사이트에 로그인할 수 있습니다.
Drupal을 Azure AD B2C와 통합하면 로그인 프로세스가 간소화되고 보안이 강화되며, 여러 비밀번호를 저장하고 기억하고 재설정할 필요성이 완전히 없어집니다.

운동장

가격 책정 계획

미팅을 잡다

설치 단계

이전 버전
새 버전

작곡가 사용
Drush 사용
수동 설치

모듈을 다운로드합니다:

작곡가는 'drupal/miniorange_oauth_client'가 필요합니다.
로 이동 하다 Drupal 관리 콘솔의 메뉴에서 다음을 검색하세요. miniOrange OAuth 클라이언트 구성 검색창을 이용하세요.
확인란을 선택하여 모듈을 활성화하고 설치 버튼을 클릭합니다.
다음 위치에서 모듈을 구성할 수 있습니다.

{BaseURL}/admin/config/people/miniorange_oauth_client/config_clc

모듈 설치:

drush 및 drupal/miniorange_oauth_client
캐시 지우기:

드러쉬 cr
다음 위치에서 모듈을 구성할 수 있습니다.

{BaseURL}/admin/config/people/miniorange_oauth_client/config_clc

참고 : 수동 설치는 Drupal 7, Drupal 8, Drupal 9와만 호환됩니다.

로 이동 하다 Drupal 관리 콘솔의 메뉴에서 다음을 클릭하세요. 새로운 모듈 설치.
드루팔 설치 OAuth 및 OpenID Connect 로그인 - OAuth2 클라이언트 SSO 로그인 모듈을 zip을 다운로드하거나 URL에서 다운로드하여 패키지(tar/zip).
를 클릭하십시오 새로 추가된 모듈 활성화.
확인란을 선택하여 이 모듈을 활성화하고 다음을 클릭하세요. 설치 버튼을 클릭합니다.
다음 위치에서 모듈을 구성할 수 있습니다.

{BaseURL}/admin/config/people/miniorange_oauth_client/config_clc

작곡가 사용
Drush 사용
수동 설치

모듈을 다운로드합니다:

작곡가는 'drupal/miniorange_oauth_client'가 필요합니다.
로 이동 하다 Drupal 관리 콘솔의 메뉴에서 다음을 검색하세요. miniOrange OAuth 클라이언트 구성 검색창을 이용하세요.
확인란을 선택하여 모듈을 활성화하고 설치 버튼을 클릭합니다.
다음 위치에서 모듈을 구성할 수 있습니다.

{BaseURL}/admin/config/people/mo-oauth-client/mo-client-config

모듈 설치:

drush 및 drupal/miniorange_oauth_client
캐시 지우기:

드러쉬 cr
다음 위치에서 모듈을 구성할 수 있습니다.

{BaseURL}/admin/config/people/mo-oauth-client/mo-client-config

참고 : 수동 설치는 Drupal 7, Drupal 8, Drupal 9와만 호환됩니다.

로 이동 하다 Drupal 관리 콘솔의 메뉴에서 다음을 클릭하세요. 새로운 모듈 설치.
드루팔 설치 OAuth 및 OpenID Connect 로그인 - OAuth2 클라이언트 SSO 로그인 모듈을 zip을 다운로드하거나 URL에서 다운로드하여 패키지(tar/zip).
를 클릭하십시오 새로 추가된 모듈 활성화.
확인란을 선택하여 이 모듈을 활성화하고 다음을 클릭하세요. 설치 버튼을 클릭합니다.
다음 위치에서 모듈을 구성할 수 있습니다.

{BaseURL}/admin/config/people/mo-oauth-client/mo-client-config

구성 단계

Drupal을 OAuth 클라이언트로 구성

We Buy Orders 신청서를 클릭하세요. 구성 → 사람들 → miniOrange OAuth 클라이언트 구성 관리 메뉴에서. (/admin/config/people/miniorange_oauth_client)

Drupal OAuth 클라이언트 - mimiorange OAuth 클라이언트 구성 선택

OAuth 구성 탭에서 드롭다운에서 원하는 OAuth 공급자를 선택합니다.

참고 : 원하는 OAuth 공급자가 드롭다운에 나열되어 있지 않으면 선택하십시오. 사용자 정의 OAuth 공급자/사용자 정의 OpenID 공급자 계속하십시오.

복사 콜백/리디렉션 URL 가까운 곳에 보관하세요. OAuth 공급자를 구성할 때 필요합니다.

참고 : 공급자가 HTTPS 콜백/리디렉션 URL만 지원하고 HTTP 사이트가 있는 경우 탭 하단에 있는 'HTTPS 콜백 URL 적용' 확인란을 활성화하세요.

OAuth 공급자 이름을 입력하세요. 표시 이름 텍스트 필드.

Drupal을 OAuth 클라이언트로 구성

We Buy Orders 신청서를 클릭하세요. 구성 → 사람들 → miniOrange OAuth 클라이언트 관리 메뉴에서. (admin/config/people/mo-oauth-client/mo-client-config)

Drupal OAuth 클라이언트 - mimiorange OAuth 클라이언트 선택

. 관리 섹션 아래 클라이언트 구성 탭에서 + 새로 추가 원하는 OAuth 클라이언트를 구성하려면 버튼을 클릭하세요.

아래의 추가 탭 드롭다운에서 원하는 OAuth 애플리케이션을 선택합니다.

참고 : 원하는 OAuth 공급자가 드롭다운에 나열되어 있지 않으면 선택하십시오. 사용자 정의 OAuth 공급자/사용자 정의 OpenID 공급자 계속하십시오.

OAuth 공급자 이름을 입력하세요. 맞춤형 앱 이름 텍스트 필드. 복사 콜백/리디렉션 URL 가까운 곳에 보관하세요. OAuth 공급자를 구성할 때 필요합니다.

Drupal OAuth 클라이언트 - 사용자 지정 앱 이름 입력 및 콜백 URL 복사

공급자가 HTTPS 콜백/리디렉션 URL만 지원하고 HTTP 사이트가 있는 경우 다음을 확인하십시오. HTTPS 콜백 URL 시행 체크 박스에 설정 탭.

마이크로소프트 애저 포털
마이크로소프트 엔트라 ID

Azure AD B2C에서 SSO 애플리케이션 만들기:

에 로그인 마이크로소프트 애저 문.
. Azure 서비스 섹션에서 선택 Azure AD B2C.

새 Azure AD B2C 애플리케이션을 빌드하려면 다음으로 이동하세요. 앱 등록 아래에 관리 섹션을 클릭한 다음 왼쪽 탐색 패널에서 신규 등록 버튼을 클릭합니다.

. 신청서 등록 창에서 새 애플리케이션을 만드는 데 필요한 정보를 입력합니다.

이름: 애플리케이션 이름을 입력하세요. 이름 텍스트 필드.
지원되는 계정 유형: 3번째 옵션을 선택하고, 모든 조직 디렉토리의 계정(사용자 흐름을 통해 사용자를 인증하기 위해). 당신은 또한 참조 할 수 있습니다 선택 도와주세요 가치가 있다면 선택할 수 있는 옵션입니다.
에서 플랫폼 선택 드롭다운 옵션에서 '웹'을 선택하세요. 리디렉션 URI(권장). 아까 복사한 것을 붙여넣으세요 콜백/리디렉션 URL 텍스트 필드에.

온 클릭 회원가입 버튼을 클릭합니다.

Microsoft Azure AD B2C 포털, 애플리케이션 등록 창에 필수 정보를 입력하세요.

Azure AD B2C는 애플리케이션에 고유한 애플리케이션 ID를 할당합니다. 복사 애플리케이션(클라이언트) ID. 이것은 당신의 고객 ID.

이제 선택하세요 인증서 및 비밀 왼쪽 패널에서 다음을 클릭합니다. 새 클라이언트 비밀번호 버튼을 클릭하여 클라이언트 비밀번호를 생성하세요.

온 클릭 새 클라이언트 비밀번호 단추. 에서 클라이언트 비밀번호 추가 팝업창에서 필요한 정보를 입력하세요:

기술설명: 이 비밀에 대한 설명을 입력합니다.
만료: 드롭다운에서 이 비밀의 만료 기간을 선택합니다.

Microsoft Entra ID SSO - 클라이언트 비밀 추가 창에서 클라이언트 비밀 및 만료 기간을 추가합니다.

온 클릭 추가 버튼을 클릭합니다.
복사 가치관 인사말 클라이언트 비밀 탭. 이것은 고객 비밀.

Azure Active Directory 포털에서 클라이언트 비밀 값을 복사합니다.

를 클릭하십시오 Azure AD B2C | 앱 등록 링크는 왼쪽 위에서부터.

Azure AD B2C - Azure Portal에서 앱 등록을 선택합니다.

로 이동 회사 개요 탭을 클릭하세요.

$XNUMX Million 미만 베이직 라인 섹션에서 도메인 이름. 이것이 테넌트 ID가 됩니다.

Microsoft Azure AD B2C에서 SSO 애플리케이션 만들기:

에 로그인 마이크로소프트 엔트라 ID 문.
검색창에서 Azure AD B2C를 검색합니다. 선택 Azure AD B2C 검색 결과에서.

새 Azure AD B2C 애플리케이션을 빌드하려면 다음으로 이동하세요. 앱 등록 아래에 관리 섹션을 클릭한 다음 왼쪽 탐색 패널에서 신규 등록 버튼을 클릭합니다.

. 신청서 등록 창에서 새 애플리케이션을 만드는 데 필요한 정보를 입력합니다.

이름: 애플리케이션 이름을 입력하세요. 이름 텍스트 필드.
지원되는 계정 유형: 3번째 옵션을 선택하고, 모든 조직 디렉토리의 계정(사용자 흐름을 통해 사용자를 인증하기 위해). 당신은 또한 참조 할 수 있습니다 선택 도와주세요 가치가 있다면 선택할 수 있는 옵션입니다.
에서 플랫폼 선택 드롭다운 옵션에서 '웹'을 선택하세요. 리디렉션 URI(권장). 아까 복사한 것을 붙여넣으세요 콜백/리디렉션 URL 텍스트 필드에.

온 클릭 회원가입 버튼을 클릭합니다.

Azure AD B2C는 애플리케이션에 고유한 애플리케이션 ID를 할당합니다. 복사 애플리케이션(클라이언트) ID. 이것은 당신의 고객 ID.

이제 선택하세요 인증서 및 비밀 왼쪽 패널에서 다음을 클릭합니다. 새 클라이언트 비밀번호 버튼을 클릭하여 클라이언트 비밀번호를 생성하세요.
. 클라이언트 비밀번호 추가 팝업창에서 필요한 정보를 입력하세요:

기술설명: 이 비밀에 대한 설명을 입력합니다.
만료: 드롭다운에서 이 비밀의 만료 기간을 선택합니다.

온 클릭 추가 버튼을 클릭합니다.

복사 가치관 인사말 클라이언트 비밀 탭. 이것은 고객 비밀.

를 클릭하십시오 Azure AD B2C | 앱 등록 링크는 왼쪽 위에서부터.

로 이동 회사 개요 탭을 클릭하세요.
$XNUMX Million 미만 베이직 라인 섹션에서 도메인 이름. 이것이 테넌트 ID가 됩니다.

Azure AD B2C에서 사용자 흐름 정책 만들기

Microsoft Azure 포털로 이동합니다.
클라임웍스와 함께　하늘과 닿는 여정을 시작하세요 사용자 흐름 인사말 정책 안내

온 클릭 새로운 사용자 흐름 버튼을 클릭합니다.

선택 가입 및 로그인 사용자 흐름을 위한 카드/박스 사용자 흐름 만들기 패널.

선택 추천 카드/상자 아래 버전. 그런 다음 만들기 버튼을 클릭합니다.

다음 정보를 입력하십시오. 만들기 창 :

입력 이름 사용자 흐름의 예: B2C_1_ AzureB2CTest. (사용자 흐름이 생성된 후에는 변경할 수 없습니다.)
클라임웍스와 함께　하늘과 닿는 여정을 시작하세요 이메일 가입 아래에 ID 공급자.
선택 다단계 인증 귀하의 요구 사항에 따라 옵션을 선택하세요. 확실하지 않으면 기본 옵션을 유지하세요.
사용자 속성 및 토큰 클레임: 가입 과정에서 사용자로부터 수집할 클레임과 속성을 선택하세요. 더 보기 추가 옵션을 표시하는 버튼입니다. 만들기 팝업 창에서 확인란을 활성화했는지 확인하세요. 이메일 주소 ('속성 수집' 아래) 및 이메일 주소 ('반품 청구' 아래). 다른 필수 속성을 추가할 수도 있습니다. 마지막으로 Ok 버튼을 클릭합니다.

그런 다음 만들기 사용자 흐름을 추가하는 버튼입니다. (이름에 B2C_1_ 접두사가 자동으로 추가됩니다.)
복사 이름 사용자 흐름을 위해. (귀하의 정책 이름입니다)

Azure AD B2C에서 사용자 흐름 정책 만들기

이제 선택하십시오. 사용자 흐름 인사말 정책 안내

온 클릭 새로운 사용자 흐름 버튼을 클릭합니다.

선택 가입 및 로그인 사용자 흐름을 위한 카드/박스 사용자 흐름 만들기 패널.
클라임웍스와 함께　하늘과 닿는 여정을 시작하세요 추천 아래 버전 섹션을 클릭하고 만들기

다음 정보를 입력하십시오. 만들기 창 :

입력 이름 사용자 흐름의 예: B2C_1_ AzureB2CTest. (사용자 흐름이 생성된 후에는 변경할 수 없습니다.)
클라임웍스와 함께　하늘과 닿는 여정을 시작하세요 이메일 가입 아래에 ID 공급자.
선택 다단계 인증 귀하의 요구 사항에 따라 옵션을 선택하세요. 확실하지 않으면 기본 옵션을 유지하세요.
사용자 속성 및 토큰 클레임: 가입 과정에서 사용자로부터 수집할 클레임과 속성을 선택하세요. 더 보기 추가 옵션을 표시하는 버튼입니다. 만들기 팝업 창에서 확인란을 활성화했는지 확인하세요. 이메일 주소 ('속성 수집' 아래) 및 이메일 주소 ('반품 청구' 아래). 다른 필수 속성을 추가할 수도 있습니다. 마지막으로 Ok 버튼을 클릭합니다.

그런 다음 만들기 사용자 흐름을 추가하는 버튼입니다. (이름에 B2C_1_ 접두사가 자동으로 추가됩니다.)
복사 이름 사용자 흐름을 위해. (귀하의 정책 이름입니다)

Azure AD B2C와 Drupal 통합:

miniOrange OAuth 클라이언트 모듈로 이동합니다.
OAuth 구성 탭에서 Microsoft Entra ID에서 복사한 애플리케이션(클라이언트) ID와 클라이언트 비밀번호를 붙여넣습니다. 고객 ID 고객 비밀 텍스트 필드

Drupal-OAuth-SSO-Azure-AD-붙여넣기-클라이언트-ID-및-비밀_결과

이전에 복사한 것을 교체합니다. 도메인 이름 와 더불어 {테넌트 이름} 인간을 엔드포인트 승인 액세스 토큰 엔드포인트 Drupal의 텍스트 필드 OAuth 구성 탭.

Drupal OAuth 클라이언트 - 복사된 도메인 이름을 테넌트 이름 Endpoints url로 바꿉니다.

이전에 복사한 것을 교체합니다. 이름 와 더불어 {정책 이름} 인간을 엔드포인트 승인 액세스 토큰 엔드포인트 텍스트 필드.
'클라이언트 ID와 비밀번호를 헤더 또는 본문에 전송' 체크박스를 사용하면 클라이언트 ID와 비밀번호를 토큰 엔드포인트 요청의 헤더에 포함할지 본문에 포함할지 지정할 수 있습니다. 어떤 옵션을 선택해야 할지 확실하지 않으면 기본 설정을 그대로 사용할 수 있습니다.
확인란을 클릭하면 OAuth로 로그인 활성화.
이제 구성 저장 버튼을 클릭합니다.

범위:	openid
엔드포인트 승인:	https://{tenant-name}.b2clogin.com/{tenant-name}.onmicrosoft.com/{policy-name}/oauth2/v2.0/authorize
액세스 토큰 엔드포인트:	https://{tenant-name}.b2clogin.com/{tenant-name}.onmicrosoft.com/{policy-name}/oauth2/v2.0/token

Drupal OAuth/OpenID/OIDC SSO(Single Sign On), AzureB2C 붙여넣기 정책 이름

Drupal을 Microsoft Entra ID와 통합:

miniOrange OAuth 클라이언트 모듈로 이동합니다.
In 추가 탭, 복사한 것을 붙여넣습니다 고객 ID 고객 비밀 Azur AD B2C에서 고객 ID 고객 비밀 텍스트 필드.

Drupal-Auth-SSO-AWS Cognito-Paste-클라이언트-자격 증명

이전에 복사한 것을 교체합니다. 도메인 이름 와 더불어 {테넌트 이름} 인간을 엔드포인트 승인 액세스 토큰 엔드포인트 텍스트 필드.

범위:	openid
엔드포인트 승인:	https://{tenant-name}.b2clogin.com/{tenant-name}.onmicrosoft.com/{policy-name}/oauth2/v2.0/authorize
액세스 토큰 엔드포인트:	https://{tenant-name}.b2clogin.com/{tenant-name}.onmicrosoft.com/{policy-name}/oauth2/v2.0/token

Drupal-Auth-SSO-AWS Cognito-Endpoints 필드에 초기 URL을 Cognito 도메인으로 교체합니다.

The 헤더 또는 본문에 클라이언트 ID 및 비밀번호 보내기 체크박스를 사용하면 클라이언트 ID와 비밀번호를 토큰 엔드포인트 요청의 헤더에 포함할지, 본문에 포함할지 지정할 수 있습니다. 어떤 옵션을 선택해야 할지 확실하지 않으면 기본 설정을 그대로 사용할 수 있습니다.
확인란을 클릭하면 OAuth로 로그인 활성화을 클릭하고 아래로 스크롤한 후 구성 저장 버튼을 클릭합니다.

Drupal OAuth OpenID OIDC SSO(Single Sign On) OAuth로 로그인 확인란을 활성화하고 구성 저장을 클릭합니다.

Drupal과 OAuth Provider 간 테스트 연결

구성을 성공적으로 저장한 후 다음을 클릭하십시오. 테스트 구성 수행 Drupal과 OAuth Provider 간의 연결을 테스트하는 버튼입니다.

테스트 구성 팝업에서 동일한 브라우저에 활성 세션이 없는 경우 OAuth 공급자에 로그인하라는 메시지가 표시됩니다. 로그인이 완료되면 OAuth 공급자로부터 수신한 속성 목록이 제공됩니다.
선택 이메일 속성 사용자의 이메일 ID를 얻은 드롭다운 메뉴에서 다음을 클릭합니다. 선택한다 버튼을 클릭합니다.

참고 : SSO를 수행하려면 이메일 속성을 매핑해야 합니다. 즉, OAuth 공급자 자격 증명을 사용하여 Drupal 사이트에 로그인해야 합니다.

에 속성 및 역할 매핑 탭에서 다음을 선택하세요. 사용자 이름 속성 드롭다운 목록에서 다음을 클릭하세요. 구성 저장 버튼을 클릭합니다.

Drupal OAuth 클라이언트 - 사용자 속성을 선택하고 구성 저장을 클릭합니다.

이제 로그아웃하고 Drupal 사이트의 로그인 페이지로 이동하세요. 거기에 OAuth 공급자로 로그인 링크가 자동으로 표시됩니다. 다른 페이지에도 SSO 링크를 추가하려면 아래 이미지에 나와 있는 단계를 따르세요.

Drupal과 OAuth Provider 간 테스트 연결

구성을 성공적으로 저장한 후 테스트 구성 수행 Drupal과 OAuth Provider 간의 연결을 테스트하는 버튼입니다.

테스트 구성 팝업에서 동일한 브라우저에 활성 세션이 없는 경우 OAuth 공급자에 로그인하라는 메시지가 표시됩니다. 로그인이 완료되면 OAuth 공급자로부터 수신한 속성 목록이 제공됩니다.
온 클릭 매핑 구성 버튼을 클릭합니다.

에 속성 매핑 탭에서 다음을 선택하세요. 이메일 속성 사용자 이름 속성 드롭다운 목록에서 구성 저장 버튼을 클릭합니다.

참고 : SSO를 수행하려면 이메일 속성을 매핑해야 합니다. 즉, OAuth 공급자 자격 증명을 사용하여 Drupal 사이트에 로그인해야 합니다.

이제 로그아웃하고 Drupal 사이트의 로그인 페이지로 이동하세요. 거기에 OAuth 공급자로 로그인 링크가 자동으로 표시됩니다. 다른 페이지에도 SSO 링크를 추가하려면 아래 이미지에 나와 있는 단계를 따르세요.

도움이 필요하다?

구성 중에 문제가 발생하거나 추가 기능을 원하는 경우 다음 주소로 문의해 주세요. drupalsupport@xecurify.com.

추가 기능:

문제 해결 :

더 많은 FAQ ➔

오류 발생: '사용자 이름을 받지 못했습니다. 속성 매핑 구성을 확인하세요.' 또는 오류 발생: '이메일을 받지 못했습니다. 속성 매핑 구성을 확인하세요.'

언급된 단계를 따르세요. 여기를 클릭하십시오.

"헤더 또는 본문에서 클라이언트 자격 증명을 찾을 수 없습니다"라는 메시지가 나타납니다.
테스트 구성을 수행하려고 할 때

언급된 단계를 따르세요. 여기를 클릭하십시오.

Drupal에서 로그아웃을 클릭하면 Drupal 홈페이지로 돌아갑니다. 하지만 다른 사용자로 로그인을 시도하면 로그인을 요청하지 않고 자동으로 같은 사용자로 로그인합니다.

여기서 언급한 로그아웃 기능은 모듈의 기본 동작입니다. Drupal에서 로그아웃하지만 애플리케이션/공급자에서 로그아웃하지는 않습니다. 모듈이 공급자/애플리케이션 계정에서 로그아웃하도록 허용하려면(원하는 대로) 아래 구성을 해야 합니다. [자세한 내용을 알고]

유료 Drupal 모듈을 구매하고 무료 모듈로 교체했지만 여전히 유료 기능을 사용할 수 없습니다.

Drupal 모듈의 유료 버전 중 하나로 업그레이드하고 무료 모듈을 유료 모듈로 교체했으므로 먼저 유료 모듈을 활성화해야 합니다. 아래 단계를 참조하세요. [더 많이 알아라.]

당신의 응답을 주셔서 감사합니다. 곧 다시 연락드리겠습니다.

문제가 발생했습니다. 문의사항을 다시 제출해 주세요.

목차

OAuth/OpenID 연결을 사용한 Drupal Azure AD B2C SSO 통합