Facial Authentication

Pré-requisitos:

• ID de uma Política válida.
• Provedor de Autenticação válido associado a política selecionada.
• Credenciais de Admin ou Client ID + Access Key
• Aplicativo com capacidade de capturar o padrão de digitação do usuário

Na organização do Github do TypingDNA existem vários exemplos de recorders de digitação para diferentes plataformas: https://github.com/TypingDNA

O mecanismo de autenticação por voz possui 3 operações básicas, Enrollment, Verify e Delete.

Enrollment

URL de Documentação da API : /apidocs/#/Credential_Typing/post_typing__policyId__enrollment

O Enrollment necessita de 4 padrões de digitação da mesma pessoa para ser executado com sucesso.

Parâmetros:

• policyId:
  • Obrigatório: Sim
  • Tipo: String
  • Localização: Caminho da URL (Path)
  • Descrição: O ID da Política que será utilizada na operação.
• username:
  • Obrigatório: Sim
  • Tipo: String
  • Localização: No corpo da requisição JSON.
  • Descrição: O nome do usuário que o MFAO irá utilizar para solicitar a criação de semente no provedor de autenticação
• tp1:
  • Obrigatório: Sim
  • Tipo: String
  • Localização: No corpo da requisição JSON.
  • Descrição: String com o padrão de digitação gravado pelo SDK do TypingDNA
• tp2:
  • Obrigatório: Sim
  • Tipo: String
  • Localização: No corpo da requisição JSON.
  • Descrição: String com o padrão de digitação gravado pelo SDK do TypingDNA
• tp3:
  • Obrigatório: Sim
  • Tipo: String
  • Localização: No corpo da requisição JSON.
  • Descrição: String com o padrão de digitação gravado pelo SDK do TypingDNA
• tp4:
  • Obrigatório: Sim
  • Tipo: String
  • Localização: No corpo da requisição JSON.
  • Descrição: String com o padrão de digitação gravado pelo SDK do TypingDNA
• verbose:
  • Obrigatório: Não
  • Tipo: Booleano
  • Localização: No corpo da requisição JSON.
  • Descrição: Caso o valor seja true, irá retornar diversar métricas sobre a requisição e resposta, default=false.

Exemplos:

• Curl:

    curl -X POST \
    -H 'content-type: application/json' \
    -H 'api-key: $API_KEY' \
    -H 'access-key: $ACCESS_KEY' \
    "https://authfy-mfao.example/api/typing/$POLICY_ID/enrollment" \
    -d '{"username": "john", "tp1": "$TYPING_PATTERN1", "tp2": "$TYPING_PATTERN2", "tp3": "$TYPING_PATTERN3", "tp4": "$TYPING_PATTERN4"}'
  

Verify

URL de Documentação da API : /apidocs/#/Credential_Typing/post_typing__policyId__verify

Parâmetros:

• policyId:
  • Obrigatório: Sim
  • Tipo: String
  • Localização: Caminho da URL (Path)
  • Descrição: O ID da Política que será utilizada na operação.
• username:
  • Obrigatório: Sim
  • Tipo: String
  • Localização: No corpo da requisição JSON.
  • Descrição: O nome do usuário que o MFAO irá utilizar para testar a autenticação no provedor de autenticação
• tp:
  • Obrigatório: Sim
  • Tipo: String
  • Localização: No corpo da requisição JSON.
  • Descrição: String com o padrão de digitação gravado pelo SDK do TypingDNA
• verbose:
  • Obrigatório: Não
  • Tipo: Booleano
  • Localização: No corpo da requisição JSON.
  • Descrição: Caso o valor seja true, irá retornar diversar métricas sobre a requisição e resposta, default=false.

Exemplos:

• Curl:

    curl -X POST \
    -H 'content-type: application/json' \
    -H 'api-key: $API_KEY' \
    -H 'access-key: $ACCESS_KEY' \
    "https://authfy-mfao.example/api/typing/$POLICY_ID/verify" \
    -d '{"username": "john", "tp": "$TYPING_PATTERN"}'
  

Delete

URL de Documentação da API : /apidocs/#/Credential_Typing/post_typing__policyId__delete

Parâmetros:

• policyId:
  • Obrigatório: Sim
  • Tipo: String
  • Localização: Caminho da URL (Path)
  • Descrição: O ID da Política que será utilizado na operação.
• username:
  • Obrigatório: Sim
  • Tipo: String
  • Localização: No corpo da requisição JSON.
  • Descrição: O nome do usuário que o MFAO irá utilizar para deletar a semente no provedor de autenticação.
• verbose:
  • Obrigatório: Não
  • Tipo: Booleano
  • Localização: No corpo da requisição JSON.
  • Descrição: Caso o valor seja true, irá retornar diversar métricas sobre a requisição e resposta, default=false.

Exemplos:

• Curl:

    curl -X POST \
    -H 'content-type: application/json' \
    -H 'api-key: $API_KEY' \
    -H 'access-key: $ACCESS_KEY' \
    "https://authfy-mfao.example/api/typing/$POLICY_ID/delete" \
    -d '{"username": "john"}'