Crear credenciales de dispositivo

Cree una clave pública de credencial de dispositivo para administrar la rotación del token de actualización de un user_id determinado. Las API de Device Credentials están diseñadas únicamente para uso administrativo ad hoc y la paginación está habilitada de forma predeterminada para las solicitudes GET.

Cuando la rotación del token de actualización está habilitada, el endpoint se vuelve consistente. Para obtener más información, consulte Signing Keys.

POST https://{tenantDomain}/api/v2/device-credentials

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.CreatePublicKeyDeviceCredentialRequestContent{
        DeviceName: "device_name",
        Type: management.DeviceCredentialPublicKeyTypeEnum(
            "public_key",
        ),
        Value: "value",
        DeviceId: "device_id",
    }
    client.DeviceCredentials.CreatePublicKey(
        context.TODO(),
        request,
    )
}

import { ManagementClient } from "auth0";

async function main() {
    const client = new ManagementClient({
        token: "<token>",
    });
    await client.deviceCredentials.createPublicKey({
        deviceName: "device_name",
        type: "public_key",
        value: "value",
        deviceId: "device_id",
    });
}
main();

import { ManagementClient } from "auth0";

async function main() {
    const client = new ManagementClient({
        token: "<token>",
    });
    await client.deviceCredentials.createPublicKey({
        deviceName: "device_name",
        type: "public_key",
        value: "value",
        deviceId: "device_id",
    });
}
main();

curl --request POST \
  --url https://{tenantDomain}/api/v2/device-credentials \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "device_id": "<string>",
  "device_name": "<string>",
  "type": "public_key",
  "value": "<string>",
  "client_id": "<string>"
}
'

import requests

url = "https://{tenantDomain}/api/v2/device-credentials"

payload = {
    "device_id": "<string>",
    "device_name": "<string>",
    "type": "public_key",
    "value": "<string>",
    "client_id": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{tenantDomain}/api/v2/device-credentials",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'device_id' => '<string>',
    'device_name' => '<string>',
    'type' => 'public_key',
    'value' => '<string>',
    'client_id' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

HttpResponse<String> response = Unirest.post("https://{tenantDomain}/api/v2/device-credentials")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"device_id\": \"<string>\",\n  \"device_name\": \"<string>\",\n  \"type\": \"public_key\",\n  \"value\": \"<string>\",\n  \"client_id\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{tenantDomain}/api/v2/device-credentials")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"device_id\": \"<string>\",\n  \"device_name\": \"<string>\",\n  \"type\": \"public_key\",\n  \"value\": \"<string>\",\n  \"client_id\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

201

{
  "id": "dcr_0000000000000001"
}

Autorizaciones

bearerAuthoAuth2ClientCredentials

Authorization · string · header · requerido

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

Cuerpo

application/jsonapplication/x-www-form-urlencoded

device_id · string · requerido

Identificador único del dispositivo. Se recomienda usar Android_ID en Android e identifierForVendor.

Maximum string length: 36

Pattern: ^[-A-Fa-f0-9]+$

device_name · string · requerido

Nombre para este dispositivo que el propietario pueda reconocer fácilmente.

Minimum string length: 1

type · enum<string> · requerido

Tipo de credencial. Debe ser public_key.

Opciones disponibles: public_key

value · string · requerido

Cadena codificada en Base64 que contiene la credential.

Minimum string length: 1

client_id · string<client-id>

client_id del cliente (aplicación) al que corresponde esta credencial.

Respuesta

201

application/json

Las credenciales del dispositivo se crearon correctamente.

id · string · predeterminado: dcr_0000000000000001 · requerido

El identificador de la credencial