POST de cambio de contraseña

Cree un ticket de cambio de contraseña para un usuario determinado. Un ticket de cambio de contraseña es una URL generada que el usuario puede usar para iniciar un flujo de Restablecer contraseña.

Nota: Este endpoint no verifica la identidad del usuario indicado. Si llama a este endpoint desde su aplicación, debe diseñar su aplicación para verificar la identidad del usuario.

POST https://{tenantDomain}/api/v2/tickets/password-change

Go

Go

package example

import (
    context "context"

    management "github.com/auth0/go-auth0/management/management"
    client "github.com/auth0/go-auth0/management/management/client"
    option "github.com/auth0/go-auth0/management/management/option"
)

func do() {
    client := client.NewClient(
        option.WithToken(
            "<token>",
        ),
    )
    request := &management.ChangePasswordTicketRequestContent{}
    client.Tickets.ChangePassword(
        context.TODO(),
        request,
    )
}

201

{
  "ticket": "https://login.auth0.com/lo/reset?client_id=nsaPS2p3cargoFy82WT7betaOPOt3qSh&tenant=mdocs&bewit=bmNlR01CcDNOUE1GeXVzODJXVDdyY1RUT1BPdDNxU2hcMTQzMDY2MjE4MVxuRTcxM0RSeUNlbEpzUUJmaFVaS3A1NEdJbWFzSUZMYzRTdEFtY2NMMXhZPVx7ImVtYWloojoiZGFtaWtww2NoQGhvdG1haWwuY29tIiwidGVuYW50IjoiZHNjaGVua2tjwWFuIiwiY2xpZW50X2lkIjoibmNlR01CcDNOUE1GeXVzODJXVDdyY1RUT1BPiiqxU2giLCJjb25uZWN0aW9uIjoiRGFtaWmsdiwicmVzdWx0VXJsIjoiIn0"
}

Autorizaciones

bearerAuthoAuth2ClientCredentials

Authorization · string · header · requerido

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Encabezados

auth0-custom-domain · string

Dominio personalizado que se usará para esta solicitud

Required string length: 3 - 255

Cuerpo

application/jsonapplication/x-www-form-urlencoded

client_id · string<client-id> · predeterminado: DaM8bokEXBWrTUFCiJjWn50jei6ardyX

ID del cliente (aplicación). Si se proporciona para inquilinos que usan la experiencia New Universal Login, la plantilla de correo electrónico y la IU mostrarán los detalles de la aplicación, y se pedirá al usuario que redirija a la ruta de inicio de sesión predeterminada de la aplicación después de usar el ticket. client_id es obligatorio para usar el desencadenador Password Reset Post Challenge.

connection_id · string · predeterminado: con_0000000000000001

ID de la conexión. Si se proporciona, permite especificar al usuario mediante el correo electrónico en lugar de user_id. Si establece este valor, también debe enviar el parámetro email. No puede enviar user_id al especificar un connection_id.

Pattern: ^con_[A-Za-z0-9]{16}$

email · string<email>

Dirección de correo electrónico del usuario para el que se deben crear los tickets. Requiere el parámetro connection_id. No se puede especificar al usar user_id.

identity · object · EA

La identidad del usuario. Si establece este valor, también debe enviar el parámetro user_id.

Show child attributes

includeEmailInRedirect · boolean

Si se debe incluir la dirección de correo electrónico como parte de la returnUrl en reset_email (true) o no (false).

mark_email_as_verified · boolean · predeterminado: false

Si se debe establecer el atributo email_verified en true (true) o no actualizarlo (false).

organization_id · string<organization-id> · predeterminado: org_2eondWoxcMIpaLQc

(Opcional) ID de la Organización: el ID de la Organización. Si se proporciona, los parámetros de la organización estarán disponibles para la plantilla de correo electrónico y la marca de la organización se aplicará a la pantalla. Además, el enlace de redirección de la pantalla incluirá los parámetros de cadena de consulta organization_id y organization_name.

result_url · string<url> · predeterminado: http://myapp.com/callback

URL a la que se redirigirá al usuario en la experiencia clásica de Universal Login una vez que se use el ticket. No se puede especificar al usar organization_id. Puede especificarse junto con client_id cuando el inquilino tenga habilitada una página personalizada de restablecimiento de contraseña y una Action de Password Reset Post Challenge vinculada.

ttl_sec · integer

Número de segundos durante los que el ticket es válido antes de vencer. Si no se especifica o se establece en 0, este valor será de 432000 segundos (5 días) de forma predeterminada.

Rango requerido: x >= 0

user_id · string<user-id>

user_id para el que se debe crear el ticket.

Respuesta

201

application/json

Ticket creado correctamente.

ticket · string<url> · predeterminado: https://login.auth0.com/lo/reset?client_id=nsaPS2p3cargoFy82WT7betaOPOt3qSh&tenant=mdocs&bewit=bmNlR01CcDNOUE1GeXVzODJXVDdyY1RUT1BPdDNxU2hcMTQzMDY2MjE4MVxuRTcxM0RSeUNlbEpzUUJmaFVaS3A1NEdJbWFzSUZMYzRTdEFtY2NMMXhZPVx7ImVtYWloojoiZGFtaWtww2NoQGhvdG1haWwuY29tIiwidGVuYW50IjoiZHNjaGVua2tjwWFuIiwiY2xpZW50X2lkIjoibmNlR01CcDNOUE1GeXVzODJXVDdyY1RUT1BPiiqxU2giLCJjb25uZWN0aW9uIjoiRGFtaWmsdiwicmVzdWx0VXJsIjoiIn0 · requerido

URL que representa el ticket.