다음을 통해 공유

ID 사기에 대처하고 신뢰할 수 있는 사용자 환경을 만들기 위해 Deduce를 사용하여 Azure Active Directory B2C 구성

중요합니다

2025년 5월 1일부터 새 고객을 위해 Azure AD B2C를 더 이상 구매할 수 없습니다. FAQ에서 자세히 알아보세요.

이 샘플 문서에서는 Azure AD B2C(Azure Active Directory B2C) 인증을 Deduce와 통합하는 방법에 대한 지침을 제공합니다. Deduce는 인터넷에서 가장 빠르게 증가하는 사기인 계정 인수 및 등록 사기를 중지하는 데 초점을 맞추고 있습니다. Deduce Identity Network는 하루에 14억 번 이상 Deduce와 로그인, 등록 및 체크 아웃을 공유하는 150,000개 이상의 웹 사이트 및 앱 연합을 통해 제공됩니다.

결과 ID 인텔리전스는 재무 문제와 기업의 책임이 되기 전에 공격을 중지합니다. 조직이 최상의 고객을 위해 마찰 없는 사용자 환경을 제공할 수 있도록 기록 동작 분석을 신뢰의 예측자로 사용합니다. 포괄적인 범위의 위험 및 신뢰 신호는 Azure AD B2C 인스턴스를 사용하여 모든 인증 결정을 알릴 수 있습니다. 이러한 통합을 통해 조직은 등록 또는 로그인 프로세스 중에 Azure AD B2C 기능을 확장하여 Deduce Insights API에서 사용자에 대한 추가 인사이트를 얻을 수 있습니다. Deduce API에서 수집한 특성 중 일부는 다음과 같습니다.

  • 전자 메일
  • IP 주소
  • 사용자 에이전트

필수 조건

시작하려면 다음이 필요합니다.

시나리오 설명

통합에는 다음 구성 요소가 포함됩니다.

  • Azure AD B2C – ID 공급자라고도 하는 사용자의 자격 증명 확인을 담당하는 권한 부여 서버입니다.
  • Deduce – Deduce 서비스는 사용자가 제공한 입력을 사용하고 사용자의 ID에 대한 디지털 작업 인사이트를 제공합니다.
  • 사용자 지정 rest API – 이 API는 Azure AD B2C와 Deduce Insights API 간의 통합을 구현합니다.

다음 아키텍처 다이어그램은 구현을 보여줍니다 . 이미지는 아키텍처 다이어그램을 보여줍니다.

단계 설명
1. 사용자가 Azure AD B2C의 로그인 페이지를 연 다음 사용자 이름을 입력하여 로그인하거나 등록합니다.
2. Azure AD B2C는 중간 계층 API를 호출하고 사용자 특성을 전달합니다.
3. 중간 계층 API는 사용자 특성을 수집하고 Deduce API에서 사용할 수 있는 형식으로 변환한 다음, Deduce로 보냅니다.
4. Deduce는 정보를 사용하고 이를 처리하여 위험 분석을 기반으로 사용자 식별의 유효성을 검사합니다. 그런 다음 중간 계층 API에 결과를 반환합니다.
5. 중간 계층 API는 정보를 처리하고 올바른 JSON 형식의 위험, 신뢰 및 정보 신호를 Azure AD B2C로 다시 보냅니다.
6. Azure AD B2C는 중간 계층 API에서 정보를 다시 받습니다.
오류 응답이 표시되면 사용자에게 오류 메시지가 표시됩니다.
성공 응답이 표시되면 사용자는 인증되고 디렉터리에 기록됩니다.

Deduce를 사용하여 온보딩

Deduce 계정을 만들려면 Deduce 지원에 문의하세요. 계정이 만들어지면 API 구성에 필요한 사이트 ID 및 API 키를 받게 됩니다.

다음 섹션에서는 통합 프로세스에 대해 설명합니다.

1단계: Azure AD B2C 정책 구성

시작 팩 가져오기의 지침에 따라 Azure AD B2C 테넌트를 설정하고 정책을 구성하는 방법을 알아봅니다. 이 샘플 문서는 로컬 계정 시작 팩을 기반으로 합니다.

2단계: Azure AD B2C 사용자 인터페이스 사용자 지정

클라이언트 측에서 user_agent를 수집하려면 관련된 JavaScript를 포함하여 사용할 임의의 ID를 사용해 자신의 **ContentDefinition**를 만드세요. 최종 사용자 브라우저의 user_agent 문자열을 확인하고 Azure AD B2C에 클레임으로 저장합니다.

  1. api.selfasserted, selfAsserted.cshtml을 로컬로 다운로드합니다.

  2. selfAsserted.cshtml을 편집하여 </head> 종료 전에 다음 JavaScript를 포함하고, 기본 패널을 숨기는 추가 스타일 요소를 정의합니다.

    <style>
 .panel-default   {
 margin: 0 auto;
 width: 60%;
 height: 0px;
 background-color: #296ec6;
 opacity: 1;
 border-radius: .5rem;
 border: none;
 color: #fff;
 font-size: 1em;
 box-shadow: 0 0 30px 0 #dae1f7;
 visibility: hidden;
} 

</style>

  3. 을 닫기 전에 다음 JavaScript 코드를 추가합니다 </body>. 이 코드는 사용자의 브라우저에서 user_agent를 읽고, ContentDefinition은 자체 주장된 기술 프로필과 결합하여 user_agent를 다음 오케스트레이션 단계의 출력 클레임으로 반환합니다.

    <script>
     $("#user_agent").hide().val(window.navigator.userAgent);
     var img = new Image();
     img.onload = function() {
     document.getElementById("continue").click();
  };
     img.src = "https://login.microsoftonline.com/static/tenant/templates/images/logo.svg";
</script>

3단계: 스토리지 위치 구성

  1. 스토리지 계정에서 Blob Storage 컨테이너를 설정하고 이전에 편집한 **selfAsserted.cshtml** 파일을 Blob 컨테이너에 업로드합니다.

  2. 다음 지침에 따라 만든 스토리지 컨테이너에 대한 CORS 액세스를 허용합니다.

    1. 설정>허용된 출처로 이동하여 https://your_tenant_name.b2clogin.com 입력합니다. your-tenant- name를 fabrikam와 같은 Azure AD B2C 테넌트 이름으로 바꾸십시오. 테넌트 이름을 입력할 때 모든 소문자를 사용합니다.

    2. 허용되는 메서드의 경우 GET 및 PUT를 선택합니다.

    3. 저장을 선택합니다.

4단계: 콘텐츠 정의 구성

사용자 인터페이스를 사용자 지정하려면 사용자 지정된 HTML 콘텐츠를 사용하여 요소에 ContentDefinition URL을 지정합니다. 자체 어설션된 기술 프로필 또는 오케스트레이션 단계에서 해당 ContentDefinition 식별자를 가리킵니다.

  1. TrustFrameworksExtension.xml를 열고 새로운 ContentDefinition을 정의하여 자체 어설션된 기술 프로필을 사용자 지정합니다.

  2. BuildingBlocks 요소를 찾아 ContentDefinition을 **api.selfassertedDeduce** 추가합니다.

     <BuildingBlocks>
 ...
 <ContentDefinitions>
   <ContentDefinition Id="api.selfassertedDeduce">
     <LoadUri>https://<STORAGE-ACCOUNT-NAME>.blob.core.windows.net/<CONTAINER>/selfAsserted.cshtml</LoadUri>
     <RecoveryUri>~/common/default_page_error.html</RecoveryUri>
     <DataUri>urn:com:microsoft:aad:b2c:elements:contract:selfasserted:2.1.7</DataUri>
     <Metadata>
       <Item Key="DisplayName">Signin and Signup Deduce</Item>
     </Metadata>
   </ContentDefinition>
 </ContentDefinitions>
   ...
</BuildingBlocks>

LoadUri를 selfAsserted.cshtml에서 만든 파일을 가리키는 URL로 바꿉다.

5단계: Deduce 추가 ClaimType 추가

ClaimsSchema 요소는 정책의 일부로 참조할 수 있는 클레임 형식을 정의합니다. Deduce에서 지원하고 추가할 수 있는 추가 클레임이 있습니다.

  1. TrustFrameworksExtension.xml을 여세요.

  2. 요소에서 **BuildingBlocks** Deduce에서 지원하는 추가 ID 클레임을 추가할 수 있습니다.

      <BuildingBlocks>
...
 <ClaimsSchema>
  <!-- Claims for Deduce API request body -->
   <ClaimType Id="site">
     <DisplayName>Site ID</DisplayName>
     <DataType>string</DataType>
     <AdminHelpText>Deduce Insight API site id</AdminHelpText>
   </ClaimType>

   <ClaimType Id="ip">
     <DisplayName>IP Address</DisplayName>
     <DataType>string</DataType>
     <AdminHelpText>Add help text here</AdminHelpText>
   </ClaimType>

   <ClaimType Id="apikey">
     <DisplayName>API Key</DisplayName>
     <DataType>string</DataType>
     <AdminHelpText>Add help text here</AdminHelpText>
   </ClaimType>

   <ClaimType Id="action">
     <DisplayName>Contextual action</DisplayName>
     <DataType>string</DataType>
     <AdminHelpText>Add help text here</AdminHelpText>
   </ClaimType>

   <!-- End of Claims for Deduce API request body -->

   <!-- Rest API call request body to deduce insight API -->
   <ClaimType Id="deduce_requestbody">
     <DisplayName>Request body for insight api</DisplayName>
     <DataType>string</DataType>
     <AdminHelpText>Request body for insight api</AdminHelpText>
   </ClaimType>

   <ClaimType Id="deduce_trust_response">
     <DisplayName>Response body for insight api</DisplayName>
     <DataType>string</DataType>
     <AdminHelpText>Response body for insight api</AdminHelpText>
   </ClaimType>
   <!-- End of Rest API call request body to deduce insight API -->

   <!-- Response claims from Deduce Insight  API -->

   <ClaimType Id="data.signals.trust">
     <DisplayName>Trust collection</DisplayName>
     <DataType>stringCollection</DataType>
     <AdminHelpText>List of asserted trust</AdminHelpText>
   </ClaimType>

   <ClaimType Id="data.signals.info">
     <DisplayName>Trust collection</DisplayName>
     <DataType>stringCollection</DataType>
     <AdminHelpText>List of asserted info</AdminHelpText>
   </ClaimType>

   <ClaimType Id="data.signals.risk">
     <DisplayName>Trust collection</DisplayName>
     <DataType>stringCollection</DataType>
     <AdminHelpText>List of asserted risk</AdminHelpText>
   </ClaimType>

   <ClaimType Id="data.network.company_name">
     <DisplayName>data.network.company_name</DisplayName>
     <DataType>string</DataType>
     <AdminHelpText>List of asserted risk</AdminHelpText>
   </ClaimType>
   <ClaimType Id="data.network.crawler_name">
     <DisplayName>data.network.crawler_name</DisplayName>
     <DataType>string</DataType>
     <AdminHelpText>List of asserted risk</AdminHelpText>
   </ClaimType>
   <ClaimType Id="data.network.is_corporate">
     <DisplayName>data.network.is_corporate</DisplayName>
     <DataType>boolean</DataType>
     <AdminHelpText>List of asserted risk</AdminHelpText>
   </ClaimType>
   <ClaimType Id="data.network.is_education">
     <DisplayName>data.network.is_education</DisplayName>
     <DataType>boolean</DataType>
     <AdminHelpText>List of asserted risk</AdminHelpText>
   </ClaimType>
   <ClaimType Id="data.network.is_hosting">
     <DisplayName>data.network.is_hosting</DisplayName>
     <DataType>boolean</DataType>
     <AdminHelpText>List of asserted risk</AdminHelpText>
   </ClaimType>
   <ClaimType Id="data.network.is_mobile">
     <DisplayName>data.network.is_mobile</DisplayName>
     <DataType>boolean</DataType>
     <AdminHelpText>List of asserted risk</AdminHelpText>
   </ClaimType>
   <ClaimType Id="data.network.is_proxy">
     <DisplayName>data.network.is_proxy"</DisplayName>
     <DataType>boolean</DataType>
     <AdminHelpText>List of asserted risk</AdminHelpText>
   </ClaimType>
   <ClaimType Id="data.network.is_tor">
     <DisplayName>data.network.is_tor</DisplayName>
     <DataType>boolean</DataType>
     <AdminHelpText>List of asserted risk</AdminHelpText>
   </ClaimType>
   <ClaimType Id="data.network.is_vpn_capable">
     <DisplayName>data.network.is_vpn_capable</DisplayName>
     <DataType>boolean</DataType>
     <AdminHelpText>List of asserted risk</AdminHelpText>
   </ClaimType>
   <ClaimType Id="data.network.is_vpn_confirmed">
     <DisplayName>data.network.is_vpn_confirmed</DisplayName>
     <DataType>boolean</DataType>
     <AdminHelpText>List of asserted risk</AdminHelpText>
   </ClaimType>
   <ClaimType Id="data.network.is_vpn_suspect">
     <DisplayName>data.network.is_vpn_suspect</DisplayName>
     <DataType>boolean</DataType>
     <AdminHelpText>List of asserted risk</AdminHelpText>
   </ClaimType>
   <ClaimType Id="data.network.isp_name">
     <DisplayName>data.network.isp_name</DisplayName>
     <DataType>string</DataType>
     <AdminHelpText>List of asserted risk</AdminHelpText>
   </ClaimType>
   <ClaimType Id="data.network.vpn_name">
     <DisplayName>data.network.vpn_name</DisplayName>
     <DataType>string</DataType>
     <AdminHelpText>List of asserted risk</AdminHelpText>
   </ClaimType>
   <ClaimType Id="data.geo.city">
     <DisplayName>data.geo.city</DisplayName>
     <DataType>string</DataType>
     <AdminHelpText>List of asserted risk</AdminHelpText>
   </ClaimType>
   <ClaimType Id="data.geo.country">
     <DisplayName>data.geo.country</DisplayName>
     <DataType>string</DataType>
     <AdminHelpText>List of asserted risk</AdminHelpText>
   </ClaimType>
   <ClaimType Id="data.geo.lat">
     <DisplayName>data.geo.lat</DisplayName>
     <DataType>string</DataType>
     <AdminHelpText>List of asserted risk</AdminHelpText>
   </ClaimType>
   <ClaimType Id="data.geo.long">
     <DisplayName>data.geo.long</DisplayName>
     <DataType>string</DataType>
     <AdminHelpText>List of asserted risk</AdminHelpText>
   </ClaimType>
   <ClaimType Id="data.geo.state">
     <DisplayName>data.geo.state</DisplayName>
     <DataType>string</DataType>
     <AdminHelpText>List of asserted risk</AdminHelpText>
   </ClaimType>
   <ClaimType Id="data.device.ua_brand">
     <DisplayName>data.device.ua_brand</DisplayName>
     <DataType>string</DataType>
     <AdminHelpText>List of asserted risk</AdminHelpText>
   </ClaimType>
   <ClaimType Id="data.device.ua_browser">
     <DisplayName>data.device.ua_browser</DisplayName>
     <DataType>string</DataType>
     <AdminHelpText>List of asserted risk</AdminHelpText>
   </ClaimType>
   <ClaimType Id="data.device.ua_device_type">
     <DisplayName>data.device.ua_device_type</DisplayName>
     <DataType>string</DataType>
     <AdminHelpText>List of asserted risk</AdminHelpText>
   </ClaimType>
   <ClaimType Id="data.device.ua_name">
     <DisplayName>data.device.ua_name</DisplayName>
     <DataType>string</DataType>
     <AdminHelpText>List of asserted risk</AdminHelpText>
   </ClaimType>
   <ClaimType Id="data.device.ua_os">
     <DisplayName>data.device.ua_os</DisplayName>
     <DataType>string</DataType>
     <AdminHelpText>List of asserted risk</AdminHelpText>
   </ClaimType>
   <ClaimType Id="data.device.ua_type">
     <DisplayName>data.device.ua_type</DisplayName>
     <DataType>string</DataType>
     <AdminHelpText>List of asserted risk</AdminHelpText>
   </ClaimType>
   <ClaimType Id="data.device.ua_version">
     <DisplayName>data.device.ua_version</DisplayName>
     <DataType>string</DataType>
     <AdminHelpText>List of asserted risk</AdminHelpText>
   </ClaimType>
   <ClaimType Id="data.activity.email.ip_count">
     <DisplayName>data.activity.email.ip_count</DisplayName>
     <DataType>int</DataType>
     <AdminHelpText>Add help text here</AdminHelpText>
   </ClaimType>
   <ClaimType Id="data.activity.email.lastseen">
     <DisplayName>data.activity.email.lastseen</DisplayName>
     <DataType>string</DataType>
     <AdminHelpText>Add help text here</AdminHelpText>
   </ClaimType>
   <ClaimType Id="data.activity.email.frequency">
     <DisplayName>data.activity.email.frequency</DisplayName>
     <DataType>int</DataType>
     <AdminHelpText>Add help text here</AdminHelpText>
   </ClaimType>
   <ClaimType Id="data.activity.emailip.frequency">
     <DisplayName>data.activity.emailip.frequency</DisplayName>
     <DataType>int</DataType>
     <AdminHelpText>Add help text here</AdminHelpText>
   </ClaimType>
   <ClaimType Id="data.activity.emailip.lastseen">
     <DisplayName>data.activity.emailip.lastseen</DisplayName>
     <DataType>string</DataType>
     <AdminHelpText>Add help text here</AdminHelpText>
   </ClaimType>
   <ClaimType Id="data.activity.emailip.match">
     <DisplayName>data.activity.emailip.match</DisplayName>
     <DataType>boolean</DataType>
     <AdminHelpText>Add help text here</AdminHelpText>
   </ClaimType>
   <ClaimType Id="data.activity.emailip.rank_email">
     <DisplayName>data.activity.emailip.rank_email</DisplayName>
     <DataType>int</DataType>
     <AdminHelpText>Add help text here</AdminHelpText>
   </ClaimType>
   <ClaimType Id="data.activity.emailip.rank_ip">
     <DisplayName>data.activity.emailip.rank_ip</DisplayName>
     <DataType>int</DataType>
     <AdminHelpText>Add help text here</AdminHelpText>
   </ClaimType>
   <ClaimType Id="data.activity.ip.email_count">
     <DisplayName>data.activity.ip.email_count</DisplayName>
     <DataType>int</DataType>
     <AdminHelpText>Add help text here</AdminHelpText>
   </ClaimType>
   <ClaimType Id="data.activity.ip.lastseen">
     <DisplayName>data.activity.ip.lastseen</DisplayName>
     <DataType>string</DataType>
     <AdminHelpText>Add help text here</AdminHelpText>
   </ClaimType>

   <ClaimType Id="data.activity.ip.frequency">
     <DisplayName>data.activity.ip.frequency</DisplayName>
     <DataType>int</DataType>
     <AdminHelpText>Add help text here</AdminHelpText>
   </ClaimType>

   <ClaimType Id="data.sent_timestamp">
     <DisplayName>datasent_timestamp</DisplayName>
     <DataType>long</DataType>
     <AdminHelpText>Add help text here</AdminHelpText>
   </ClaimType>

   <ClaimType Id="user_agent">
     <DisplayName>User Agent</DisplayName>
     <DataType>string</DataType>
     <UserHelpText>Add help text here</UserHelpText>
     <UserInputType>TextBox</UserInputType>
   </ClaimType>

   <ClaimType Id="correlationId">
     <DisplayName>correlation ID</DisplayName>
     <DataType>string</DataType>
   </ClaimType>
 <!-- End Response claims from Deduce Insight API -->
 ...
 </ClaimsSchema>
 ...
 </BuildingBlocks>

6단계: Deduce ClaimsProvider 추가

클레임 공급자는 기술 프로필을 통해 다양한 유형의 당사자와 통신하는 인터페이스입니다.

Deduce를 정책의 확장 파일의 ClaimsProvider 요소에 추가하여 클레임 공급자로 정의할 수 있습니다.

  1. TrustFrameworkExtensions.xml 파일을 엽니다.

  2. ClaimsProvider 요소를 찾습니다. 존재하지 않는 경우 다음과 같이 새 ClaimsProvider 를 추가합니다.

     <ClaimsProvider>
   <DisplayName>Deduce REST API</DisplayName>
   <TechnicalProfiles>
     <TechnicalProfile Id="SelfAsserted-UserAgent">
       <DisplayName>Pre-login</DisplayName>
       <Protocol Name="Proprietary" Handler="Web.TPEngine.Providers.SelfAssertedAttributeProvider, Web.TPEngine, Version=1.0.0.0, Culture=neutral,         PublicKeyToken=null" />
       <Metadata>
         <Item Key="ContentDefinitionReferenceId">api.selfassertedDeduce</Item>
         <Item Key="setting.showCancelButton">false</Item>
         <Item Key="language.button_continue">Continue</Item>
       </Metadata>
       <OutputClaims>
         <OutputClaim ClaimTypeReferenceId="user_agent" />
       </OutputClaims>
     </TechnicalProfile>
     <TechnicalProfile Id="deduce_insight_api">
       <DisplayName>Get customer insight data from deduce api</DisplayName>
       <Protocol Name="Proprietary" Handler="Web.TPEngine.Providers.RestfulProvider, Web.TPEngine, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />
       <Metadata>
         <Item Key="ServiceUrl">https://deduceproxyapi.azurewebsites.net/api/Deduce/DeduceInsights</Item>
         <Item Key="AuthenticationType">None</Item>
         <Item Key="SendClaimsIn">Body</Item>
         <Item Key="ResolveJsonPathsInJsonTokens">true</Item>
         <Item Key="AllowInsecureAuthInProduction">true</Item>
         <Item Key="DebugMode">true</Item>
         <Item Key="IncludeClaimResolvingInClaimsHandling">true</Item>
       </Metadata>
       <InputClaims>
         <InputClaim ClaimTypeReferenceId="user_agent" />
         <InputClaim ClaimTypeReferenceId="signInNames.emailAddress" PartnerClaimType="email" />
         <InputClaim ClaimTypeReferenceId="ip" DefaultValue="{Context:IPAddress}" AlwaysUseDefaultValue="true" />
         <InputClaim ClaimTypeReferenceId="apikey" DefaultValue="<DEDUCE API KEY>" />
         <InputClaim ClaimTypeReferenceId="action" DefaultValue="auth.success.password" />
         <InputClaim ClaimTypeReferenceId="site" DefaultValue="<SITE>" />
       </InputClaims>
       <OutputClaims>
         <OutputClaim ClaimTypeReferenceId="data.sent_timestamp" PartnerClaimType="data.sent_timestamp" />
         <OutputClaim ClaimTypeReferenceId="data.activity.ip.frequency" PartnerClaimType="data.activity.ip.frequency" />
         <OutputClaim ClaimTypeReferenceId="data.activity.ip.lastseen" PartnerClaimType="data.activity.ip.lastseen" />
         <OutputClaim ClaimTypeReferenceId="data.activity.ip.email_count" PartnerClaimType="data.activity.ip.email_count" />
         <OutputClaim ClaimTypeReferenceId="data.activity.email.ip_count" PartnerClaimType="data.activity.email.ip_count" />
         <OutputClaim ClaimTypeReferenceId="data.activity.email.lastseen" PartnerClaimType="data.activity.email.lastseen" />
         <OutputClaim ClaimTypeReferenceId="data.activity.email.frequency" PartnerClaimType="data.activity.email.frequency" />
         <OutputClaim ClaimTypeReferenceId="data.activity.emailip.frequency" PartnerClaimType="data.activity.emailip.frequency" />
         <OutputClaim ClaimTypeReferenceId="data.activity.emailip.lastseen" PartnerClaimType="data.activity.emailip.lastseen" />
         <OutputClaim ClaimTypeReferenceId="data.activity.emailip.match" PartnerClaimType="data.activity.emailip.match" />
         <OutputClaim ClaimTypeReferenceId="data.activity.emailip.rank_email" PartnerClaimType="data.activity.emailip.rank_email" />
         <OutputClaim ClaimTypeReferenceId="data.activity.emailip.rank_ip" PartnerClaimType="data.activity.emailip.rank_ip" />
         <OutputClaim ClaimTypeReferenceId="data.signals.trust" PartnerClaimType="data.signals.trust" />
         <OutputClaim ClaimTypeReferenceId="data.signals.info" PartnerClaimType="data.signals.info" />
         <OutputClaim ClaimTypeReferenceId="data.signals.risk" PartnerClaimType="data.signals.risk" />
         <OutputClaim ClaimTypeReferenceId="data.network.company_name" PartnerClaimType="data.network.company_name" />
         <OutputClaim ClaimTypeReferenceId="data.network.crawler_name" PartnerClaimType="data.network.crawler_name" />
         <OutputClaim ClaimTypeReferenceId="data.network.is_corporate" PartnerClaimType="data.network.is_corporate" />
         <OutputClaim ClaimTypeReferenceId="data.network.is_education" PartnerClaimType="data.network.is_education" />
         <OutputClaim ClaimTypeReferenceId="data.network.is_hosting" PartnerClaimType="data.network.is_hosting" />
         <OutputClaim ClaimTypeReferenceId="data.network.is_mobile" PartnerClaimType="data.network.is_mobile" />
         <OutputClaim ClaimTypeReferenceId="data.network.is_proxy" PartnerClaimType="data.network.is_proxy" />
         <OutputClaim ClaimTypeReferenceId="data.network.is_tor" PartnerClaimType="data.network.is_tor" />
         <OutputClaim ClaimTypeReferenceId="data.network.is_vpn_capable" PartnerClaimType="data.network.is_vpn_capable" />
         <OutputClaim ClaimTypeReferenceId="data.network.is_vpn_confirmed" PartnerClaimType="data.network.is_vpn_confirmed" />
         <OutputClaim ClaimTypeReferenceId="data.network.is_vpn_suspect" PartnerClaimType="data.network.is_vpn_suspect" />
         <OutputClaim ClaimTypeReferenceId="data.network.isp_name" PartnerClaimType="data.network.isp_name" />
         <OutputClaim ClaimTypeReferenceId="data.network.vpn_name" PartnerClaimType="data.network.vpn_name" />
         <OutputClaim ClaimTypeReferenceId="data.geo.city" PartnerClaimType="data.geo.city" />
         <OutputClaim ClaimTypeReferenceId="data.geo.country" PartnerClaimType="data.geo.country" />
         <OutputClaim ClaimTypeReferenceId="data.geo.lat" PartnerClaimType="data.geo.lat" />
         <OutputClaim ClaimTypeReferenceId="data.geo.long" PartnerClaimType="data.geo.long" />
         <OutputClaim ClaimTypeReferenceId="data.geo.state" PartnerClaimType="data.geo.state" />
         <OutputClaim ClaimTypeReferenceId="data.device.ua_brand" PartnerClaimType="data.device.ua_brand" />
         <OutputClaim ClaimTypeReferenceId="data.device.ua_browser" PartnerClaimType="data.device.ua_browser" />
         <OutputClaim ClaimTypeReferenceId="data.device.ua_device_type" PartnerClaimType="data.device.ua_device_type" />
         <OutputClaim ClaimTypeReferenceId="data.device.ua_name" PartnerClaimType="data.device.ua_name" />
         <OutputClaim ClaimTypeReferenceId="data.device.ua_os" PartnerClaimType="data.device.ua_os" />
         <OutputClaim ClaimTypeReferenceId="data.device.ua_type" PartnerClaimType="data.device.ua_type" />
         <OutputClaim ClaimTypeReferenceId="data.device.ua_version" PartnerClaimType="data.device.ua_version" />
       </OutputClaims>
     </TechnicalProfile>
   </TechnicalProfiles>
 </ClaimsProvider>

초기 온보딩 시 Deduce에서 제공한 정보로 apikey 및 site를 대체합니다.

7단계: 사용자 경험 추가

이 시점에서 Deduce RESTfull API 가 설정되었지만 아직 등록 또는 로그인 페이지에서는 사용할 수 없습니다. 사용자 고유의 사용자 지정 사용자 여정이 없는 경우 기존 템플릿 사용자 경험의 중복을 만들고, 그렇지 않으면 다음 단계로 계속 진행합니다.

  1. TrustFrameworkBase.xml 시작 팩에서 파일을 엽니다.

  2. 를 포함하는 Id=SignUpOrSignIn 요소의 전체 콘텐츠를 찾아 복사합니다.

  3. TrustFrameworkExtensions.xml를 열고 UserJourneys 요소를 찾습니다. 요소가 없으면 추가합니다.

  4. UserJourneys 요소의 자식으로 복사한 UserJourney 요소의 전체 콘텐츠를 붙여넣습니다.

  5. 사용자 여정 Id의 이름을 변경합니다. 예를 들어 Id=CustomSignUpSignIn

8단계: 사용자 경험에 추론 API 추가

이제 사용자 경험을 완료했으므로 Deduce를 호출하는 오케스트레이션 단계를 추가합니다.

  1. 사용자 여정에서 Type=CombinedSignInAndSignUp 또는 Type=ClaimsProviderSelection를 포함하는 오케스트레이션 단계 요소를 찾습니다. 일반적으로 첫 번째 오케스트레이션 단계입니다.

  2. 기술 프로필 SelfAsserted-UserAgent을 호출하는 오케스트레이션 단계를 새로 추가합니다.

  3. 기술 프로필 **deduce_insight_api**을 호출하는 오케스트레이션 단계를 새로 추가합니다.

    UserJourney의 아래 예제는 로컬 계정 시작 팩을 기반으로 합니다.

     <UserJourneys>
  <UserJourney Id="CustomSignUpOrSignIn">
   <OrchestrationSteps>
     <OrchestrationStep Order="1" Type="ClaimsExchange">
       <ClaimsExchanges>
         <ClaimsExchange Id="Browser-UserAgent" TechnicalProfileReferenceId="SelfAsserted-UserAgent" />
       </ClaimsExchanges>
     </OrchestrationStep>
     <OrchestrationStep Order="2" Type="CombinedSignInAndSignUp" ContentDefinitionReferenceId="api.signuporsignin">
       <ClaimsProviderSelections>
         <ClaimsProviderSelection ValidationClaimsExchangeId="LocalAccountSigninEmailExchange" />
       </ClaimsProviderSelections>
       <ClaimsExchanges>
         <ClaimsExchange Id="LocalAccountSigninEmailExchange" TechnicalProfileReferenceId="SelfAsserted-LocalAccountSignin-Email" />
       </ClaimsExchanges>
     </OrchestrationStep>

     <OrchestrationStep Order="3" Type="ClaimsExchange">
       <Preconditions>
         <Precondition Type="ClaimsExist" ExecuteActionsIf="true">
           <Value>objectId</Value>
           <Action>SkipThisOrchestrationStep</Action>
         </Precondition>
       </Preconditions>
       <ClaimsExchanges>
         <ClaimsExchange Id="SignUpWithLogonEmailExchange" TechnicalProfileReferenceId="LocalAccountSignUpWithLogonEmail" />
       </ClaimsExchanges>
     </OrchestrationStep>

     <!-- This step reads any user attributes that we may not have received when in the token. -->
     <OrchestrationStep Order="4" Type="ClaimsExchange">
       <ClaimsExchanges>
         <ClaimsExchange Id="AADUserReadWithObjectId" TechnicalProfileReferenceId="AAD-UserReadUsingObjectId" />
       </ClaimsExchanges>
     </OrchestrationStep>
     <OrchestrationStep Order="5" Type="ClaimsExchange">
       <ClaimsExchanges>
         <ClaimsExchange Id="DecideInsights" TechnicalProfileReferenceId="deduce_insight_api" />
       </ClaimsExchanges>
     </OrchestrationStep>
     <OrchestrationStep Order="6" Type="SendClaims" CpimIssuerTechnicalProfileReferenceId="JwtIssuer" />

   </OrchestrationSteps>
   <ClientDefinition ReferenceId="DefaultWeb" />
 </UserJourney>
</UserJourneys>

9단계: 신뢰 당사자 정책 구성

신뢰 당사자 정책은 Azure AD B2C가 실행할 사용자 경험을 지정합니다. SignUpOrSignIn_WithDeduce TechnicalProfile 요소의 OutputClaims 요소를 조정하여 애플리케이션에 전달되는 클레임을 제어할 수도 있습니다. 이 샘플에서 애플리케이션은 중간 계층 API에서 정보를 다시 받습니다.

    <RelyingParty>
        <DefaultUserJourney ReferenceId="CustomSignUpOrSignIn" />
        <UserJourneyBehaviors>
            <ScriptExecution>Allow</ScriptExecution>
        </UserJourneyBehaviors>
        <TechnicalProfile Id="PolicyProfile">
            <DisplayName>PolicyProfile</DisplayName>
            <Protocol Name="OpenIdConnect" />
            <OutputClaims>
                <!-- <OutputClaim ClaimTypeReferenceId="user_agent"   /> -->
                <OutputClaim ClaimTypeReferenceId="displayName" />
                <OutputClaim ClaimTypeReferenceId="givenName" />
                <OutputClaim ClaimTypeReferenceId="surname" />
                <OutputClaim ClaimTypeReferenceId="email" />
                <OutputClaim ClaimTypeReferenceId="correlationId" DefaultValue="{Context:CorrelationId}" />
                <OutputClaim ClaimTypeReferenceId="data.sent_timestamp" PartnerClaimType="data.sent_timestamp" />
                <OutputClaim ClaimTypeReferenceId="data.activity.ip.frequency" PartnerClaimType="data.activity.ip.frequency" />
                <OutputClaim ClaimTypeReferenceId="data.activity.ip.lastseen" PartnerClaimType="data.activity.ip.lastseen" />
                <OutputClaim ClaimTypeReferenceId="data.activity.ip.email_count" PartnerClaimType="data.activity.ip.email_count" />
                <OutputClaim ClaimTypeReferenceId="data.activity.email.ip_count" PartnerClaimType="data.activity.email.ip_count" />
                <OutputClaim ClaimTypeReferenceId="data.activity.email.lastseen" PartnerClaimType="data.activity.email.lastseen" />
                <OutputClaim ClaimTypeReferenceId="data.activity.email.frequency" PartnerClaimType="data.activity.email.frequency" />
                <OutputClaim ClaimTypeReferenceId="data.activity.emailip.frequency" PartnerClaimType="data.activity.emailip.frequency" />
                <OutputClaim ClaimTypeReferenceId="data.activity.emailip.lastseen" PartnerClaimType="data.activity.emailip.lastseen" />
                <OutputClaim ClaimTypeReferenceId="data.activity.emailip.match" PartnerClaimType="data.activity.emailip.match" />
                <OutputClaim ClaimTypeReferenceId="data.activity.emailip.rank_email" PartnerClaimType="data.activity.emailip.rank_email" />
                <OutputClaim ClaimTypeReferenceId="data.activity.emailip.rank_ip" PartnerClaimType="data.activity.emailip.rank_ip" />
                <OutputClaim ClaimTypeReferenceId="data.signals.trust" PartnerClaimType="data.signals.trust" />
                <OutputClaim ClaimTypeReferenceId="data.signals.info" PartnerClaimType="data.signals.info" />
                <OutputClaim ClaimTypeReferenceId="data.signals.risk" PartnerClaimType="data.signals.risk" />
                <OutputClaim ClaimTypeReferenceId="data.network.company_name" PartnerClaimType="data.network.company_name" />
                <OutputClaim ClaimTypeReferenceId="data.network.crawler_name" PartnerClaimType="data.network.crawler_name" />
                <OutputClaim ClaimTypeReferenceId="data.network.is_corporate" PartnerClaimType="data.network.is_corporate" />
                <OutputClaim ClaimTypeReferenceId="data.network.is_education" PartnerClaimType="data.network.is_education" />
                <OutputClaim ClaimTypeReferenceId="data.network.is_hosting" PartnerClaimType="data.network.is_hosting" />
                <OutputClaim ClaimTypeReferenceId="data.network.is_mobile" PartnerClaimType="data.network.is_mobile" />
                <OutputClaim ClaimTypeReferenceId="data.network.is_proxy" PartnerClaimType="data.network.is_proxy" />
                <OutputClaim ClaimTypeReferenceId="data.network.is_tor" PartnerClaimType="data.network.is_tor" />
                <OutputClaim ClaimTypeReferenceId="data.network.is_vpn_capable" PartnerClaimType="data.network.is_vpn_capable" />
                <OutputClaim ClaimTypeReferenceId="data.network.is_vpn_confirmed" PartnerClaimType="data.network.is_vpn_confirmed" />
                <OutputClaim ClaimTypeReferenceId="data.network.is_vpn_suspect" PartnerClaimType="data.network.is_vpn_suspect" />
                <OutputClaim ClaimTypeReferenceId="data.network.isp_name" PartnerClaimType="data.network.isp_name" />
                <OutputClaim ClaimTypeReferenceId="data.network.vpn_name" PartnerClaimType="data.network.vpn_name" />
                <OutputClaim ClaimTypeReferenceId="data.geo.city" PartnerClaimType="data.geo.city" />
                <OutputClaim ClaimTypeReferenceId="data.geo.country" PartnerClaimType="data.geo.country" />
                <OutputClaim ClaimTypeReferenceId="data.geo.lat" PartnerClaimType="data.geo.lat" />
                <OutputClaim ClaimTypeReferenceId="data.geo.long" PartnerClaimType="data.geo.long" />
                <OutputClaim ClaimTypeReferenceId="data.geo.state" PartnerClaimType="data.geo.state" />
                <OutputClaim ClaimTypeReferenceId="data.device.ua_brand" PartnerClaimType="data.device.ua_brand" />
                <OutputClaim ClaimTypeReferenceId="data.device.ua_browser" PartnerClaimType="data.device.ua_browser" />
                <OutputClaim ClaimTypeReferenceId="data.device.ua_device_type" PartnerClaimType="data.device.ua_device_type" />
                <OutputClaim ClaimTypeReferenceId="data.device.ua_name" PartnerClaimType="data.device.ua_name" />
                <OutputClaim ClaimTypeReferenceId="data.device.ua_os" PartnerClaimType="data.device.ua_os" />
                <OutputClaim ClaimTypeReferenceId="data.device.ua_type" PartnerClaimType="data.device.ua_type" />
                <OutputClaim ClaimTypeReferenceId="data.device.ua_version" PartnerClaimType="data.device.ua_version" />
                <OutputClaim ClaimTypeReferenceId="tenantId" AlwaysUseDefaultValue="true" DefaultValue="{Policy:TenantObjectId}" />
                <OutputClaim ClaimTypeReferenceId="objectId" PartnerClaimType="sub" />
            </OutputClaims>
            <SubjectNamingInfo ClaimType="sub" />
        </TechnicalProfile>
    </RelyingParty>

10단계: 사용자 지정 정책 업로드

  1. Azure Portal에 로그인합니다.

  2. 여러 테넌트에 액세스할 수 있는 경우 상단 메뉴의 설정 아이콘을 선택하여 디렉터리 + 구독 메뉴에서 Azure AD B2C 테넌트로 전환합니다.

  3. Azure Portal에서 Azure AD B2C를 검색하여 선택합니다.

  4. 정책에서 ID 환경 프레임워크를 선택합니다.

  5. 사용자 지정 정책 업로드를 선택한 다음, 변경한 두 개의 정책 파일을 다음 순서대로 업로드합니다. 확장 정책(예TrustFrameworkBase.xml: 신뢰 당사자 정책 등B2C_1A_signup).

11단계: 사용자 지정 정책 테스트

  1. 신뢰 당사자 정책을 선택하세요, 예를 들어 B2C_1A_signup.

  2. 애플리케이션의 경우 이전에 등록한 웹 애플리케이션을 선택합니다. 회신 URL에는 https://jwt.ms가 표시되어야 합니다.

  3. 지금 실행 단추를 선택합니다.

  4. 등록 정책은 Deduce를 즉시 호출해야 합니다. 로그인을 사용하는 경우 Deduce를 선택하여 Deduce로 로그인합니다.

로그인 프로세스가 성공하면 브라우저가 리디렉션되어 https://jwt.msAzure AD B2C에서 반환된 토큰의 내용이 표시됩니다.

다음 단계

자세한 내용은 다음 문서를 검토하세요.

  • Last updated on