Integrando o aplicativo Twilio Verify com o Azure Active Directory B2C

Neste passo a passo, saiba como integrar um aplicativo de pagamento online de exemplo no Azure Active Directory B2C (Azure AD B2C) com a API Twilio Verify. Usando o aplicativo Twilio Verify, os clientes do Azure AD B2C podem cumprir os requisitos de transação PSD2 (Diretiva de Serviços de Pagamento 2) por meio de vinculação dinâmica e autenticação forte do cliente.

Pré-requisitos

Para começar, você precisará de:

• Uma assinatura do Azure. Se você não tiver uma assinatura, poderá obter uma conta gratuita.
• Um locatário do Azure AD B2C que está vinculado à sua assinatura do Azure.
• Uma conta de avaliação no Twilio.

Descrição do cenário

Os seguintes componentes compõem a solução da Twilio:

• Aplicativo Web de demonstração do .NET PSD2, que fornece a capacidade de entrar ou se inscrever e executar uma transação fictícia de alto risco.

• Azure AD B2C combinou a política de autenticação e registro.

• Política integrada do Azure AD B2C com a API de Verificação do Twilio usando id_token_hint.

• Aplicativo Web .NET, que hospeda um .well-known ponto de extremidade OpenIdConnect para permitir a validação de um id_token_hint.

  

Integração com a Twilio

1. Obtenha uma conta de avaliação na Twilio.

2. Compre um número de telefone na Twilio, conforme descrito neste artigo

3. Navegue até Verify API no console da Twilio e siga as instruções para criar um serviço e habilitar a opção PSD2.

Configurar o aplicativo de demonstração PSD2

1. Abra a solução B2C-WebAPI-DotNet e substitua os seguintes valores pelos seus próprios valores específicos de locatário no web.config:

   <add key="ida:Tenant" value="yourtenant.onmicrosoft.com" />
   <add key="ida:TenantId" value="aaaabbbb-0000-cccc-1111-dddd2222eeee" />
   <add key="ida:ClientId" value="00001111-aaaa-2222-bbbb-3333cccc4444" />
   <add key="ida:ClientSecret" value="secret" />
   <add key="ida:AadInstance" value="https://yourtenant.b2clogin.com/tfp/{0}/{1}" />
   <add key="ida:RedirectUri" value="https://your hosted psd2 demo app url/" />
   

2. O aplicativo Web também hospeda o gerador de indicador de token de ID e a interface de metadados.

   • Crie seu certificado de assinatura conforme descrito nesta descrição de exemplo.

   • Atualize as seguintes linhas com base em seu certificado no web.config:

     <add key="ida:SigningCertThumbprint" value="AA11BB22CC33DD44EE55FF66AA77BB88CC99DD00" />
     <add key="ida:SigningCertAlgorithm" value="RS256" />
     

3. Carregue o aplicativo de demonstração para o provedor de hospedagem de sua escolha. As diretrizes para o Serviço de Aplicativo do Azure são fornecidas nesta descrição de exemplo, incluindo instruções para carregar seu certificado.

4. Atualize o registro do aplicativo Azure AD B2C adicionando uma URL de resposta equivalente à URL na qual o aplicativo está hospedado.

5. Abra os arquivos de política e substitua todas as instâncias de contoso pelo nome do seu locatário.

6. Encontre o perfil técnico da API REST da Twilio Custom-SMS-Enroll. Atualize o ServiceURL com seu AccountSID do Twilio e o número De para o número de telefone comprado.

7. Encontre os perfis técnicos da API REST da Twilio, TwilioRestAPI-Verify-Step1 e TwilioRestAPI-Verify-Step2, e atualize-osServiceURL com o SID da sua conta da Twilio.

Integrar com o Azure AD B2C

Adicione os arquivos de política ao Azure AD B2C:

1. Entre no portal do Azure como o Administrador de Política IEF B2C do seu locatário do Azure AD B2C.
2. Se você tiver acesso a vários locatários, selecione o ícone Configurações no menu superior para alternar para o seu locatário do Azure Active Directory B2C no menu Diretórios + assinaturas.
3. Escolha Todos os serviços no canto superior esquerdo do portal do Azure, pesquise e selecione O Azure AD B2C.
4. Navegue até Azure AD B2C>Identity Experience Framework>Chaves de política.
5. Adicione uma nova chave com o nome B2cRestTwilioClientId. Selecione manual e forneça o valor do Twilio AccountSID.
6. Adicione uma nova chave com o nome B2cRestTwilioClientSecret. Selecione manual e forneça o valor do Twilio AUTH TOKEN.
7. Carregar todos os arquivos de política para o seu locatário.
8. Personalize a cadeia de caracteres na transformação de declaração GenerateOTPMessageEnrol para sua mensagem de texto de inscrição.

Testar a solução

• Navegue até seu aplicativo e teste as ações de entrada, inscrição e Enviar dinheiro.

Próximas etapas

Para obter informações adicionais, examine os seguintes artigos:

• Consulte GitHub para obter exemplos de código de integração da Twilio

• Políticas personalizadas no Azure AD B2C

• Introdução às políticas personalizadas no Azure AD B2C