Configurar Akamai para enviar Supplemental Signals

Configura Akamai como proxy inverso para enviar Supplemental Signals a tu tenant de Auth0.

Supplemental Signals está disponible para clientes Enterprise, y debes solicitar el complemento Attack Protection Add-on. Ponte en contacto con Auth0 Sales para obtener más información.

Antes de empezar

Para configurar Akamai para que envíe Supplemental Signals a tu tenant de Auth0, debes configurar Akamai como proxy inverso.

Si usas Akamai Bot Manager y/o Akamai Account Protector, puedes configurar tu proxy inverso en Akamai para enviar los resultados a Auth0 y usar esos resultados en Actions.

​

Flujos de inicio de sesión compatibles

Auth0 admite actualmente los siguientes flujos de inicio de sesión para Supplemental Signals:

• Universal Login: Identificador + contraseña
  • Universal Login: Primero el identificador
  • Universal Login: Registro con conexiones de base de datos
  • Universal Login: Restablecimiento de contraseña, incluidas las organizaciones de Auth0
  • Resource Owner Password Grant (ROPG)

​

Paso 1: Registrar una API en Akamai

Para que Akamai sepa cuándo los intentos de inicio de sesión se completan correctamente o fallan, tendrás que registrar una API en Akamai y luego definir un endpoint para cada flujo de inicio de sesión de Auth0 que quieras admitir.

Para obtener más información, consulta Register an API on Akamai TechDocs y Add API resources on Akamai TechDocs.

Nuevo identificador universal de inicio de sesión + contraseña

Usa los siguientes valores para registrar tu API en Akamai:

Propiedad	Valor
Ruta base de la API	/u
Ubicación de la clave de API	Cabecera

Una vez que hayas creado tu API, deberás agregar un recurso de API para cada uno de los siguientes endpoints de Auth0:

• /u/login/password
• /u/signup
• /u/signup/password

El proceso es el mismo para todos los endpoints, pero los valores de configuración varían ligeramente.

​

Agregar recurso de API

Usa los siguientes valores para configurar un recurso en tu API de Akamai:

/u/login/password

Propiedad	Valor
Parámetros de API sin definir	Specific (Request body)
Ruta	/login/password
Métodos	POST

/u/signup

Propiedad	Valor
Parámetros de API sin definir	Specific (Request body)
Ruta	/signup
Métodos	POST

/u/signup/password

Propiedad	Valor
Parámetros de API sin definir	Specific (Request body)
Ruta	/signup/password
Métodos	POST

​

Agregar parámetros a los métodos

Una vez que hayas creado tu recurso de API, deberás definir el parámetro Request body para que Akamai pueda procesar correctamente las solicitudes de inicio de sesión.

Usa los siguientes valores para definir el parámetro Request body:

/u/login/password

Propiedad	Valor
Formato	JSON
Obligatorio	Sí
Definir el formato del cuerpo	Sí
Detalles del esquema	Ver más abajo.

{
  "requestBody": {
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "required": [
            "state"
          ],
          "properties": {
            "state": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            },
            "username": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            },
            "password": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            },
            "action": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            }
          }
        }
      }
    },
    "required": true
  }
}

/u/signup

Propiedad	Valor
Formato	JSON
Obligatorio	Sí
Definir el formato del cuerpo	Sí
Detalles del esquema	Ver más abajo.

{
  "requestBody": {
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "required": [
            "email",
            "password"
          ],
          "properties": {
            "email": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            },
            "password": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            }
          }
        }
      }
    },
    "required": true
  }
}

/u/signup/password

Propiedad	Valor
Formato	JSON
Obligatorio	Sí
Definir el formato del cuerpo	Sí
Detalles del esquema	Ver más abajo.

{
  "requestBody": {
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "required": [
            "email"
          ],
          "properties": {
            "email": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256,
              "description": "email"
            }
          }
        }
      }
    },
    "required": true
  }
}

Primero, el nuevo identificador universal de inicio de sesión

Usa los siguientes valores para registrar tu API en Akamai:

Propiedad	Valor
Ruta base de la API	/u
Ubicación de la clave de API	Encabezado

Una vez que hayas creado tu API, deberás agregar un recurso de API para cada uno de los siguientes endpoints de Auth0:

• /u/login
• /u/signup
• /u/signup/password

El proceso es el mismo para todos los endpoints, pero los valores de configuración varían ligeramente.

​

Agregar recurso de API

Usa los siguientes valores para configurar un recurso en tu API de Akamai:

/u/login

Propiedad	Valor
Parámetros de API sin definir	Specific (Request body)
Ruta	/login
Métodos	POST

/u/signup

Propiedad	Valor
Parámetros de API sin definir	Specific (Request body)
Ruta	/login/signup
Métodos	POST

/u/signup/password

Propiedad	Valor
Parámetros de API sin definir	Specific (Request body)
Ruta	/signup/password
Métodos	POST

​

Agregar parámetros a los métodos

Una vez que hayas creado tu recurso de API, deberás definir el parámetro Request body para que Akamai pueda procesar correctamente las solicitudes de inicio de sesión.

Usa los siguientes valores para definir el parámetro Request body:

/u/login

Propiedad	Valor
Formato	JSON
Obligatorio	Sí
Definir el formato del cuerpo	Sí
Detalles del esquema	Ver más abajo.

{
  "requestBody": {
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "required": [
            "state"
          ],
          "properties": {
            "state": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            },
            "username": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            },
            "password": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            },
            "action": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            }
          }
        }
      }
    },
    "required": true
  }
} 

/u/signup

Propiedad	Valor
Formato	JSON
Obligatorio	Sí
Definir el formato del cuerpo	Sí
Detalles del esquema	Ver más abajo.

{
  "requestBody": {
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "required": [
            "email",
            "password"
          ],
          "properties": {
            "email": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            },
            "password": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            }
          }
        }
      }
    },
    "required": true
  }
} 

/u/signup/password

Propiedad	Valor
Formato	JSON
Obligatorio	Sí
Definir el formato del cuerpo	Sí
Detalles del esquema	Ver más abajo.

{
  "requestBody": {
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "required": [
            "email"
          ],
          "properties": {
            "email": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256,
              "description": "email"
            }
          }
        }
      }
    },
    "required": true
  }
}

ROPG

Usa los siguientes valores para registrar tu API en Akamai:

Property	Value
Ruta base de la API	Ninguna.
Ubicación de la clave de API	Header

Después de crear tu API, tendrás que agregar un recurso de API para cada uno de los siguientes endpoints de Auth0:

• /oauth/token

El proceso es el mismo para todos los endpoints, pero los valores de configuración varían ligeramente.

​

Agregar recurso de API

Usa los siguientes valores para configurar un recurso en tu API de Akamai:

/oauth/token

Property	Value
Parámetros de API sin definir	Specific (Request body)
Ruta	/oauth/token
Métodos	POST

​

Agregar parámetros a los métodos

Después de crear tu recurso de API, tendrás que definir el parámetro Request body para que Akamai pueda interpretar correctamente las solicitudes de inicio de sesión.

Usa los siguientes valores para definir el parámetro Request body:

/oauth/token

Property	Value
Formato	JSON
Obligatorio	Sí
Definir formato del cuerpo	Sí
Detalles del esquema	Ver más abajo.

{
  "requestBody": {
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "properties": {
            "username": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            },
            "password": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            }
          }
        }
      }
    },
    "required": true
  }
} 

​

Paso 2: Reenviar los resultados de bots de Akamai a Auth0

Para configurar Akamai para reenviar los resultados de bots a Auth0, consulta Forward Bot Results to Origin on Akamai TechDocs.

Es posible que el encabezado akamai-user-risk no esté presente en todas las solicitudes de inicio de sesión, ya que Akamai solo lo envía cuando genera una puntuación de riesgo del usuario.

​

Paso 3: Habilite el procesamiento de encabezados de Akamai en Auth0

Puede configurar Auth0 para aceptar las Supplemental Signals enviadas desde Akamai en el Auth0 Dashboard o mediante la Auth0 Management API.

Dashboard

Para habilitar Supplemental Signals en el Dashboard:

1. Vaya a Auth0 Dashboard > Security > Attack Protection.
2. Seleccione Supplemental Signals.
3. Active el interruptor Enable Akamai headers.

Si no ve la opción de Supplemental Signals en el Auth0 Dashboard, debe solicitar el complemento Attack Protection Add-on. Para obtener más información, póngase en contacto con Auth0 Sales.

Management API

Para habilitar Supplemental Signals con la Management API:

1. Obtenga un token de acceso para la Management API con el alcance update:attack_protection.
2. Llame al endpoint de la Management API Update the Supplemental Signals configuration for a tenant con el siguiente cuerpo:

{
  "akamai_enabled": true
}

​

Paso 4: Probar y verificar la configuración

Prueba tu configuración haciendo una llamada a cada endpoint para los flujos de inicio de sesión que hayas configurado.

Si has configurado todo correctamente:

• Los encabezados akamai-user-risk y akamai-bot headers estarán presentes en los registros de tu tenant para los eventos correspondientes.
• Puedes usar las siguientes propiedades en el objeto event de la Action posterior al inicio de sesión:
  • authentication.riskAssessment.supplemental.akamai.akamaiBot
  • authentication.riskAssessment.supplemental.akamai.akamaiUserRisk