---
title: "Authentication Audit Log"
url: "https://nov18-dev.movespot.fyi/apis/konnect-audit-log-settings-dev-3/versions/53c2c1ad-759f-4471-87e5-bbf9b44f4fd7/schemas/AuthenticationLog"
---

> Full API specification: https://nov18-dev.movespot.fyi/apis/konnect-audit-log-settings-dev-3/versions/53c2c1ad-759f-4471-87e5-bbf9b44f4fd7.md

# Authentication Audit Log

An authentication audit log entry that captures authentication attempts and their outcomes.

## OpenAPI definition

```yaml
openapi: 3.0.2
info:
  title: Konnect Audit Log Settings
  version: 3.0.5
servers:
  - url: https://us.api.konghq.com/v3
    description: United-States Production region
  - url: https://eu.api.konghq.com/v3
    description: Europe Production region
  - url: https://au.api.konghq.com/v3
    description: Australia Production region
  - url: https://me.api.konghq.com/v3
    description: Middle-East Production region
  - url: https://in.api.konghq.com/v3
    description: India Production region
  - url: https://sg.api.konghq.com/v3
    description: Singapore Production region
components:
  schemas:
    AuthenticationOutcome:
      description: The outcome of an authentication attempt.
      type: string
      enum:
        - invalid
        - success
        - not_found
        - invalid_password
        - locked
        - disabled
        - token_expired
      title: Authentication Outcome
    AuthenticationType:
      description: The type of authentication used.
      type: string
      enum:
        - invalid
        - basic
        - sso
        - pat
        - spat
        - google
        - github
        - windowslive
        - federated
      title: Authentication Type
    AuthenticationLog:
      description: An authentication audit log entry that captures authentication
        attempts and their outcomes.
      type: object
      properties:
        successful:
          description: Indicates whether authentication was successful.
          type: boolean
        principal_id:
          description: If successful, the principal ID.
          type: string
        signature:
          description: Base64 URL encoded signature of this entity.
          type: string
        org_id:
          description: If it can be determined, the organization ID.
          type: string
        outcome:
          $ref: "#/components/schemas/AuthenticationOutcome"
        authentication_type:
          $ref: "#/components/schemas/AuthenticationType"
        ts:
          description: Timestamp when the authentication event occurred.
          type: string
          format: date-time
        client_ip:
          description: IP address of the client.
          type: string
        uri:
          description: URI the request was made on.
          type: string
        user_agent:
          description: User agent making the request.
          type: string
        trace_id:
          description: Trace ID of the request.
          type: string
        portal_id:
          description: Optional Dev Portal ID.
          type: string
      example:
        type: authentication
        successful: true
        principal_id: user_1234567890abcdef
        signature: MEQCIFpL3mN8sR2vT5wO1kJ7fE9xY4cU6bV3dP8qM2nK9sA1AiB5cR7eT3pW9sN1fK4mO2vL8xY6qU5bP3zR1aM4nF7gJ
        org_id: 6945c4c4-3e06-4c5c-87e0-726d0cda4e05
        outcome: success
        authentication_type: sso
        ts: 2023-03-21T09:28:45.78Z
        client_ip: 127.0.0.1
        uri: /v2/auth/login
        user_agent: Mozilla/5.0
        trace_id: "11223344"
      required:
        - successful
        - signature
        - outcome
        - authentication_type
        - ts
        - client_ip
        - uri
        - user_agent
        - trace_id
      title: Authentication Audit Log
```
