OneSpan Developer: Intelligent Adaptive Authentication - User Registration

Hakim Aldaoub, 8 de Julho de 2020

OneSpan Intelligent Adaptive Authentication (IAA) fornece uma API REST de registro de usuário para o ambiente Sandbox para permitir que você integre facilmente a funcionalidade de registro de usuário em seu aplicativo da web ou móvel. Neste artigo, exploraremos a API de registro do usuário que reside na API OneSpan IAA Interactive Sandbox. Confira nosso blog anterior “Introdução à API do Sandbox de autenticação adaptável inteligente” para uma introdução à API do IAA Sandbox.

Antes de começarmos

Antes de explorar a API de registro do usuário, você deve primeiro ser um membro da Comunidade OneSpan e se inscrever para uma conta sandbox de Autenticação Adaptativa Inteligente gratuita. Confira nosso blog anterior ”OneSpan Cloud Solutions In Action - MyBank Web Portal Demo, Part 1” para obter instruções sobre como fazer isso.

Introdução

A API de registro de usuário permite que você forneça uma nova conta de usuário para OneSpan Intelligent Adaptive Authentication e atribua automaticamente um autenticador a essa conta de usuário recém-criada. Provisionar uma instância de usuário no Análise de risco OneSpan é essencial para alavancar as atividades abrangentes do IAA.

Navegue até a API Interativa de Registro do Usuário

Para experimentar a API de registro do usuário, navegue até a API IAA Sandbox Interactive de sua conta da Comunidade OneSpan. No editor Open API Swagger, expanda o recurso “Provisioning”. Em seguida, você encontrará uma entrada para o método HTTP Post de registro do usuário como na imagem abaixo.

Exemplo de estrutura do URL da API de registro do usuário

O URL de solicitação para esta chamada de API será semelhante ao abaixo

https: // {your_tenant_ID} .sdb.tid.onespan.cloud / v1 / users / register

Você não precisará fornecer este URL durante o tutorial. É apenas para referência. O URL será atribuído automaticamente na API interativa ao chamar o serviço da web.

Corpo de solicitação da API de registro do usuário

Na seção “Request Body” do terminal do User Register, selecione o tipo de objeto "AdaptiveRegisterUserInput" no menu suspenso, conforme mostrado abaixo. Este tipo de objeto é usado para criar um novo usuário para fins de atividades IAA. Em seguida, você obterá um exemplo de carga útil JSON para a solicitação de registro. Ele será preenchido com os objetos JSON, que são exigidos pela API do tipo de objeto "AdaptiveRegisterUserInput".

O corpo da solicitação será semelhante ao exemplo abaixo dos campos obrigatórios do ponto de extremidade “usuários / registro”.

Solicitar carga útil

{

  "objectType": "AdaptiveRegisterUserInput",

  "cddc": {

    "browserCDDC": {

                    "fingerprintRaw": "{navegador: {\" userAgent \ ": Mozilla / 5.0 
                    (Windows NT 6.1; WOW64) AppleWebKit / 537.36 (KHTML, como Gecko)
                     Chrome / 65.0.3325.181 Safari / 537.36},
                    suporte: {\ "ajax \": true, \ "boxModel \": indefinido,
                    \ "changeBubbles \": undefined, \ "checkClone \": true,
                    \ "checkOn \": verdadeiro, \ "cors \": verdadeiro,
                    \ "cssFloat \": indefinido, \ "hrefNormalized \": indefinido,
                    \ "htmlSerialize \": indefinido, \ "leaderWhitespace \": indefinido,
                    \ "noCloneChecked \": true, \ "noCloneEvent \": indefinido,
                    \ "opacity \": undefined, \ "optDisabled \": undefined,
                    \ "estilo \": indefinido, \ "submitBubbles \": indefinido,
                    \ "tbody \": undefined}, computer: {\ "screenWidth \": 2560,
                    \ "screenHeight \": 1440, \ "OS \": \ "Microsoft Windows \",
                    \ "plataforma \": \ "Win32 \"}, adicional: {}} ",

    "fingerprintHash": "e96dadc9651f5fe8f071110eb174fe8e7a17a9d7a96b3b1980c13e5b4af3a4d7"

                   }

           },

  "clientIP": "192.168.0.1",

  "relationshipRef": "userid1",

  "staticPassword": "Test1234",

  "sessionID": "4ED23EA44F23",

  "userID": "userid1"

}

Solicitar descrição dos campos obrigatórios da carga útil

Campos de dados obrigatórios JSON	Descrição	Tipo de dados de campos
cddc *	Metadados do Client Device Data Collector. Os dois campos browserCDDC e mobileCDDC são mutuamente exclusivos e coletivamente exaustivos	Tipo: string Exemplo: “browserCDDC” ou “mobileCDDC”
relacionamentoRef *	A referência de relacionamento do ID do usuário	Tipo: string Comprimento mínimo: 1 MaxLength: 150 Exemplo: iaa_user
staticPassword *	A senha estática inicial atribuída ao usuário.	Tipo: string minLength: 8 maxLength: 255 exemplo: Test1234
identificação de sessão*	Identificador de sessão do aplicativo formatado como uma string hexadecimal; comum para todas as transações relacionadas à mesma sessão.	Tipo: string padrão: ^ [0-9a-fA-F] + $ minLength: 2 maxLength: 100 exemplo: 4ed23ea44f23
ID do usuário*	Um identificador único para o usuário a ser registrado no sistema.	Tipo: string minLength: 1 maxLength: 255 exemplo: iaa_user

Chamando o Endpoint de Registro do Usuário

Agora é hora de enviar a solicitação e registrar o usuário no OneSpan IAA. Para fazer a chamada API, clique no botão “Experimente” mostrado na imagem abaixo, do lado direito da seção Método de postagem “/ users / register”. Uma vez solicitado, você receberá o corpo da resposta em formato JSON. Será semelhante à carga útil de resposta descrita na seção a seguir.

Corpo de resposta da chamada da API de registro do usuário:

Abaixo está um exemplo de corpo de resposta retornado da chamada de API “/ users / register”.



  {

    "activationPassword": "xK384IF4",

    "serialNumber": "VDS0064137",

    "riskResponseCode": 0

  }

Descrição dos campos de carga útil de resposta

activationPassword : A senha de ativação que será usada posteriormente para ativar o autenticador no dispositivo confiável do usuário final

número de série : O número de série do autenticador que é automaticamente atribuído à nova instância do usuário

riskResponseCode : O código de resposta que é específico e retornou OneSpan Risk Analytics

Assim que o processo de registro for concluído, você receberá um corpo de resposta semelhante ao exemplo acima e com um código de resposta 200 que indica o registro bem-sucedido de um novo usuário para o ambiente IAA Sandbox.

Neste blog, descrevemos como registrar um novo usuário usando a API IAA Sandbox Interactive. Também exploramos a estrutura e vimos exemplos de payloads de solicitação e resposta, que são exigidos pelo endpoint “/ users / register”. Se você tiver alguma dúvida sobre este tutorial, sinta-se à vontade para nos contatar no Fóruns do portal da comunidade OneSpan.

OneSpan Blog