Authentications

An authentication process may encompass all the validations carried out according to the policy established when the SDK was initialized. These validations and their analyses can include data on the contexts in which the user was situated at the time of the request. Subsequently, based on the defined policy and validation rules, the status of the authentication is determined.

All calls to the API are authenticated and must have the token next to Bearer prefix in the Authorization header of the request. Calls with a missing or invalid access token will return status code 401 ("Unauthorized").

The token used to make requests to the API is the access token generated according to these instructions..

Authentication attempt

get

Get a authentication attempt based on the provided attempt ID.

Path parameters

attemptIdstringRequired

Authentication attempt ID

Example: xxxxxxf41e2fcd832e6xxxxx

Header parameters

AuthorizationstringRequired

Identity Authorization Token

Example: Bearer your_token_here

Responses

200

Success

application/json

requestIdstringRequired

Unique identifier of the request.

Example: xxxxx-cecd-4643-95c7-xxxxx

idstringRequired

Identifier of authentication attempt.

Example: xxxxyheu899xxxx

createdAtstring · date-timeRequired

Creation date of the record.

Example: 2024-04-04T13:45:24.321Z

statusstring · enumRequired

Status of the operation.

Example: approvedPossible values:

contextAnalysisResultstring · enumRequired

Result of the context analysis.

Example: INVALIDPossible values:

sourceIpstringRequired

Source IP of the request.

Example: 127.0.0.1 | 2804:d0c:123:xxx:yyy:aaa:321

400

Bad Request

application/json

401

Unauthorized

application/json

404

Resource not found

application/json

500

Internal server error

application/json

get/authentications/{attemptId}

HTTPcURLJavaScriptPython

GET /authentications/{attemptId} HTTP/1.1
Host: api.identity.combateafraude.com
Authorization: text
Accept: */*

{
  "requestId": "xxxxx-cecd-4643-95c7-xxxxx",
  "id": "xxxxyheu899xxxx",
  "identity": {
    "id": "xxxxyheu899xxxx",
    "name": "John Doe",
    "personId": "000111222",
    "createdAt": "2024-01-01T13:45:24.321Z"
  },
  "policy": {
    "id": "xxxxyheu899xxxx",
    "name": "test",
    "policyId": "test",
    "createdAt": "2024-01-01T13:45:24.321Z"
  },
  "createdAt": "2024-04-04T13:45:24.321Z",
  "status": "approved",
  "context": {
    "device": {
      "info": {
        "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/127.0.0.0 Safari/537.36",
        "browser": {
          "name": "Chrome",
          "version": "127.x.x",
          "major": "127"
        },
        "engine": {
          "name": "Blink",
          "version": "127.x.x"
        },
        "os": {
          "name": "Linux",
          "version": "x86_64"
        },
        "device": {
          "vendor": "text",
          "model": "text",
          "type": "text"
        },
        "cpu": {
          "architecture": "amd64"
        },
        "timezoneFromDevice": "America/Sao_Paulo"
      },
      "fingerPrint": "ASDiknh123",
      "providedInfo": {
        "manufacturer": "Apple",
        "model": "iPhone 12",
        "operatingSystem": "IOS",
        "platform": "text"
      },
      "createdAt": "2024-01-01T13:45:24.321Z",
      "type": "web"
    },
    "location": {
      "reverseGeolocation": {
        "formattedAddress": "R. John doe, 221b - alfa, John - SP, 98811-xxx, Brazil",
        "streetName": "Rua John doe",
        "streetNumber": "221b",
        "neighborhood": "alfa",
        "city": "John",
        "region": "São Paulo",
        "regionCode": "SP",
        "country": "Brazil",
        "countryCode": "BR",
        "zipcode": "98811-xxx"
      },
      "location": {
        "type": "Point",
        "coordinates": [
          -23.560009318584633,
          -46.63763122201826
        ],
        "accuracy": "12.45",
        "usedMethod": "GPS"
      }
    },
    "network": {
      "ip": "127.0.0.1",
      "asCode": 123412,
      "asName": "Net telecom",
      "isVpn": true,
      "location": {
        "city": "São Paulo",
        "region": "São Paulo",
        "regionCode": "SP",
        "country": "Brazil",
        "countryCode": "BR"
      },
      "timezoneFromIp": "America/Sao_Paulo"
    }
  },
  "contextAnalysisResult": "INVALID",
  "authenticationMethods": {
    "face_authentication": {
      "status": "approved",
      "attempts": [
        {
          "refusalReason": "person_not_alive",
          "providedFace": {
            "signedUrl": "text"
          },
          "expectedFace": {
            "signedUrl": "text"
          },
          "faceMatch": {
            "isMatch": true,
            "similarity": "0.99814697265625"
          },
          "liveness": {
            "isAlive": true
          },
          "createdAt": "2024-01-01T13:45:24.321Z"
        }
      ]
    },
    "email_authentication": {
      "status": "approved",
      "attempts": [
        {
          "refusalReason": "expired_code",
          "expectedCode": "12345678",
          "providedCode": "12345678",
          "sentTo": "text",
          "createdAt": "2024-01-01T13:45:24.321Z"
        }
      ],
      "createdAt": "2024-01-01T13:45:24.321Z"
    },
    "sms_authentication": {
      "status": "approved",
      "attempts": [
        {
          "refusalReason": "expired_code",
          "expectedCode": "12345678",
          "providedCode": "12345678",
          "sentTo": "text",
          "createdAt": "2024-01-01T13:45:24.321Z"
        }
      ],
      "createdAt": "2024-01-01T13:45:24.321Z"
    }
  },
  "sourceIp": "127.0.0.1 | 2804:d0c:123:xxx:yyy:aaa:321",
  "contextEvaluation": {
    "device_context": {
      "status": "reproved",
      "reason": "MAX_ATTEMPTS_PER_IDENTITY"
    },
    "location_context": {
      "status": "reproved",
      "reason": "MAX_ATTEMPTS_PER_IDENTITY"
    },
    "network_context": {
      "status": "reproved",
      "reason": "MAX_ATTEMPTS_PER_IDENTITY"
    }
  }
}