Duo를 IDP로 사용하여 ASP.NET Framework SAML SSO를 구성하는 방법 가이드

회사 개요

ASP.NET SAML SSO(Single Sign-On) 모듈 활성화하는 기능을 제공합니다. SAML 싱글 사인온 ASP.NET 응용 프로그램을 위한 싱글 사인온 당신은 당신의 접근을 위해 하나의 비밀번호만 사용할 수 있습니다 ASP.NET 응용 프로그램 및 서비스. 당사 모듈은 모든 것과 호환됩니다. SAML 호환 ID 공급자. 여기서는 구성에 대한 단계별 가이드를 살펴보겠습니다. 통합 인증(SSO) ASP.NET과 듀오 치고는 듀오 IdP로서.

다운로드

가격 책정 계획

플랫폼 지원 : ASP.NET SAML SSO 모듈은 ASP.NET 3.5 이상 프레임워크를 지원합니다.

전제조건 : 다운로드 및 설치

설치하려면 miniOrange SAML SSO NuGet 패키지 .NET 애플리케이션에서 miniOrange NuGet 패키지를 애플리케이션 위에 설치하기만 하면 됩니다.

NuGet 패키지

.NET CLI

PM> NuGet\Install-Package miniOrange.SAML.SSO

설치 후 브라우저를 열고 아래 URL을 사용하여 모듈 대시보드를 탐색해 보세요.


                    
                    
                     http(s)<your-dotnet-application-base-url>?ssoaction=config

등록 페이지나 로그인 페이지가 팝업되면 애플리케이션에 miniOrange SAML SSO 모듈이 성공적으로 추가된 것입니다.

다음을 클릭하여 귀하의 계정으로 등록하거나 로그인하십시오. 회원가입 버튼을 눌러 모듈을 구성합니다.

등록이 성공적으로 완료되면 등록된 이메일 주소로 평가판 라이선스 키가 전송됩니다.

모듈을 활성화하려면 다음 중 하나를 수행하세요.

입력 라이센스 키 제공된 입력 필드에 이메일을 통해 수신되었습니다.

다운로드한 라이센스 파일을 클릭하여 업로드하세요. Click Here 버튼을 클릭합니다.

그런 다음 "위의 조건을 읽었으며 모듈을 활성화하고 싶습니다" 상자를 체크하고 클릭하십시오. 라이센스 활성화 버튼을 클릭합니다.

구성 단계

1. Duo Identity Provider에 .NET 애플리케이션 메타데이터 제공

아래에는 SAML SP 메타데이터를 가져와 ID 공급자 측에서 구성할 수 있는 두 가지 방법이 자세히 나와 있습니다.

A] SAML 메타데이터 URL 또는 메타데이터 파일 사용

. 플러그인 설정 메뉴, 찾다 서비스 제공업체 설정. 그 아래에는 메타데이터 URL과 SAML 메타데이터를 다운로드하는 옵션이 있습니다.

메타데이터 URL을 복사하거나 메타데이터 파일을 다운로드하여 ID 공급자 측에서 동일하게 구성하세요.

아래 스크린샷을 참고하시면 됩니다.

B] 메타데이터 수동 업로드

에서 서비스 제공업체 설정 섹션에서는 서비스 제공자 메타데이터를 수동으로 복사할 수 있습니다. SP 엔티티 ID, ACS URL, 싱글 로그아웃 URL 구성을 위해 ID 공급자와 공유하세요.

아래 스크린샷을 참고하시면 됩니다.

귀하의 계정에 로그인하십시오. 듀오 관리 콘솔.

[A] Duo를 ID 소스로 설정:

이 단계에서는 Single Sign-On 통합에서 Duo 기본 인증을 위한 ID 소스를 구성합니다. 여기에는 두 가지 옵션이 있습니다. Active Directory 또는 SAML ID 공급자를 추가할 수 있습니다. 이 가이드에서는 ID 소스에 대한 SAML ID 공급자를 구성합니다. 이미 ID 소스를 구성한 경우 B단계로 건너뛸 수 있습니다.
선택 싱글 사인온 왼쪽 메뉴 창에서 탭을 클릭하고 소스 추가 단추. 여기서는 Duo Single Sign-On에 대한 기본 인증 소스를 추가하겠습니다.

선택 인증 소스 as SAML ID 제공자 그리고 클릭 SAML ID 공급자 추가 버튼을 클릭합니다.

로 이동 Duo Single Sign-On 구성 섹션을 확인하고 ID 소스에서 다음 값을 제공하세요.

표시 이름	ID 공급자의 이름을 제공하세요.
엔티티 ID	입력 엔티티 ID 귀하의 신원 소스.
싱글 사인온(SSO) URL	입력 싱글 사인온 ID 소스의 URL
기존 인증서	업로드 자질 귀하의 ID 소스에서 제공

를 클릭하십시오 찜하기 구성을 저장합니다.
이제 SAML ID 공급자 구성 다운로드할 수 있는 섹션 XML 메타데이터 파일을 만들고 메타데이터 파일을 Identity Source에 제공합니다.

구성을 저장한 후 다음을 클릭합니다. Single Sign-On으로 돌아가기.
선택 브리지 속성 탭여기서는 ID 소스에서 수신한 사용자 속성을 매핑하여 Duo를 SAML ID 공급자로 구성하는 데 사용합니다.
사전 정의되어 있고 사용자 정의 브리지 속성으로 변경하거나 구성할 수 없는 몇 가지 필수 브리지 속성이 있습니다.

브리지 속성을 구성하려면 다음 2개의 매개변수를 구성해야 합니다.

브리지 속성 이름: 이는 Duo에서 SAML ID 공급자로 나중에 사용될 별칭입니다.
SAML ID 공급자 속성: 이는 ID 소스에서 수신할 속성 이름입니다. 필드 이름은 애플리케이션에 따라 다를 수 있습니다.

모든 Bridge 속성을 구성한 후 설정을 저장합니다.

[B] Duo를 IDP로 설정

ASP.NET SAML Single Sign-On(SSO) 모듈의 서비스 공급자 탭에서 다음 정보를 구성하세요. 자세한 내용은 아래 이미지를 참조하세요.

엔티티 ID	입력 SP 엔터티 ID 모듈의 서비스 공급자 메타데이터 섹션에서.
어설션 소비자 서비스(ACS) URL	입력 ACS URL 모듈의 서비스 공급자 메타데이터 섹션에서.

선택 어플리케이션 탭을 클릭한 다음 왼쪽 메뉴 창에서 애플리케이션 보호.

에 대한 검색 일반 서비스 제공자.
그런 다음 싱글 사인온 신청하고 클릭하세요 보호 버튼을 클릭합니다.

복사 메타데이터 URL, 로부터 메타 데이터 부분. 이는 ASP.NET SAML SSO(Single Sign-On) 모듈을 구성하는 데 추가로 사용됩니다.

아래로 스크롤하여 서비스 제공 업체 안내

In 이름 ID 필드 SAML 응답 섹션에서 서비스 공급자에게 NameID로 보내려는 브리지 속성을 선택합니다.

아래로 스크롤 지도 속성 필드 SAML 응답 섹션 :

아래 지침에 따라 매핑을 구성합니다.

Idp 속성: 이는 Single Sign-On 설정에서 매핑한 브리지 속성입니다. 필요에 따라 속성을 선택할 수 있습니다.

SAML 응답 속성: 이는 Idp 속성에 구성된 브리지 속성 값과 함께 SAML 응답으로 전송될 속성의 이름입니다.

구성이 완료되면 저장을 클릭합니다.

2. .NET 애플리케이션에서 Duo ID 공급자 메타데이터 구성

온 클릭 IDP를 선택하세요 새 ID 공급자를 구성하려면 버튼을 클릭하세요.

Duo를 IDP로 사용하는 ASP.NET Framework SAML SSO - 새 IDP 추가

아래의 플러그인 설정 탭에서 듀오 표시된 목록에서 ID 공급자를 선택하세요.

Okta를 IDP로 사용하는 ASP.NET Framework SAML SSO - 새 IDP 추가

모듈에서 SAML ID 공급자 메타데이터를 구성하는 방법은 두 가지가 있으며, 아래에 자세히 설명되어 있습니다.

A] IDP 메타데이터 업로드 버튼을 사용하여 메타데이터를 업로드합니다.

ID 공급자가 메타데이터 URL 또는 메타데이터 파일(.xml 형식만 해당)을 제공한 경우 다음을 사용하여 모듈에서 ID 공급자 메타데이터를 간단히 구성할 수 있습니다. IDP 메타데이터 업로드 옵션을 선택합니다.

메타데이터 URL을 복사하거나 메타데이터 파일을 다운로드하여 ID 공급자 측에서 동일하게 구성하세요.

아래 스크린샷을 참고하시면 됩니다.

사용 가능한 메타데이터 형식에 따라 옵션 중 하나를 선택할 수 있습니다.

B] ID 공급자 메타데이터를 수동으로 구성합니다.

구성한 후 아이덴티티 공급자, 그것은 당신에게 다음을 제공할 것입니다 IDP 엔터티 ID, IDP 싱글 사인온 URL SAML X509 인증서 각각 필드.

찜하기 IDP 세부 정보를 저장합니다.

3. SAML SSO 테스트

메타데이터 세부 정보를 업로드한 후 다음으로 이동합니다. ID 공급자 설정 섹션. 마우스를 올려 놓으세요 작업 선택 드롭다운을 클릭하고 테스트 구성.

아래 스크린샷은 성공적인 결과를 보여줍니다. 클릭 SSO 통합 SSO 통합을 계속 진행합니다.

모듈 측에서 오류가 발생하는 경우 아래와 비슷한 창이 표시됩니다.

오류를 해결하려면 다음 단계를 따르세요.

$XNUMX Million 미만 문제 해결 탭에서 토글을 활성화하여 플러그인 로그를 수신하세요.

활성화되면 다음으로 이동하여 플러그인 로그를 검색할 수 있습니다. 플러그인 설정 탭을 클릭하고 테스트 구성.

를 다운로드 로그 파일 인사말 문제 해결 탭을 클릭하여 무엇이 잘못되었는지 확인하세요.

당신은 공유할 수 있습니다 로그 파일 우리와 함께 aspnetsupport@xecurify.com 문제를 해결하기 위해 저희 팀에서 연락을 드릴 것입니다.

4. 속성 매핑

구성을 테스트한 후 애플리케이션 속성을 ID 공급자(IdP) 속성과 매핑합니다.

miniOrange ASP.NET SAML SSO 모듈의 왼쪽 메뉴에서 다음을 클릭하세요. 속성/역할 매핑 그림에 표시된 대로 탭합니다.

IdP에서 추가 속성을 전달하려면 속성 이름과 해당 속성 값을 입력하십시오. 사용자 정의 속성 매핑.

참고 : 모든 매핑된 속성은 세션에 저장되므로 애플리케이션에서 액세스할 수 있습니다.

속성이 매핑되면 클릭하세요. 속성 매핑 저장 변경 사항을 적용합니다.

5. 통합 코드

이 단계를 통해 세션 형태로 애플리케이션에서 SSO 사용자 정보를 검색할 수 있습니다.

당신은 또한 볼 수 있습니다 설정 둘러보기 ASP.NET 모듈 애플리케이션에서 SSO 통합이 어떻게 작동하는지 이해합니다.

사용자 속성에 액세스하려는 곳 어디에나 해당 코드 조각을 복사하여 붙여넣기만 하면 됩니다.

참고 : 평가판 모듈을 사용하면 인증된 사용자 정보가 세션 변수에 저장됩니다. 프리미엄 플러그인에서는 헤더 기반, 폼 쿠키 기반, JWT 기반 인증을 사용하여 사용자 클레임을 설정할 수 있습니다.

마우스를 올리면 작업 선택 그리고 클릭 SSO 링크를 복사합니다.

SSO를 수행하려는 애플리케이션에서 다음 URL을 링크로 사용하세요.


                    
                    
                      https://<asp.net-module-base-url>/?ssoaction=login

예를 들어 다음과 같이 사용할 수 있습니다.

                
                      <a href="https://<asp.net-module-base-url>/?ssoaction=login">Log
                    in</a>

7. 로그아웃 설정

SLO를 수행하려는 애플리케이션에 대한 링크로 다음 URL을 사용하세요.


                    
                    
                      https://<asp.net-module-base-url>/?ssoaction=logout

예를 들어 다음과 같이 사용할 수 있습니다.

                
                      <a href="https://<asp.net-module-base-url>/?ssoaction=logout">Log
                    out</a>

연락처

다음 주소로 문의하십시오. aspnetsupport@xecurify.com저희 팀이 ASP.NET Framework SAML SSO 설정을 도와드립니다. 고객님의 요구 사항에 맞춰 가장 적합한 솔루션/플랜을 선택하실 수 있도록 도와드리겠습니다.

목차