Create a device public key credential

Create a device credential public key to manage refresh token rotation for a given user_id. Device Credentials APIs are designed for ad-hoc administrative use only and paging is by default enabled for GET requests.

When refresh token rotation is enabled, the endpoint becomes consistent. For more information, read Signing Keys.

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

C#

C#

using Auth0.ManagementApi;
using System.Threading.Tasks;

public partial class Examples
{
    public async Task Example() {
        var client = new ManagementClient(
            token: "<token>"
        );

        await client.DeviceCredentials.CreatePublicKeyAsync(
            new CreatePublicKeyDeviceCredentialRequestContent {
                DeviceName = "device_name",
                Type = "public_key",
                Value = "value",
                DeviceId = "device_id"
            }
        );
    }

}

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,
    )
}

package com.example.usage;

import com.auth0.client.mgmt.ManagementApi;
import com.auth0.client.mgmt.resources.devicecredentials.requests.CreatePublicKeyDeviceCredentialRequestContent;

public class Example {
    public static void main(String[] args) {
        ManagementApi client = ManagementApi
            .builder()
            .token("<token>")
            .build();

        client.deviceCredentials().createPublicKey(
            CreatePublicKeyDeviceCredentialRequestContent
                .builder()
                .deviceName("device_name")
                .type("public_key")
                .value("value")
                .deviceId("device_id")
                .build()
        );
    }
}

<?php

namespace Example;

use Auth0\SDK\API\Management\Management;
use Auth0\SDK\API\Management\DeviceCredentials\Requests\CreatePublicKeyDeviceCredentialRequestContent;

$client = new Management(
    token: '<token>',
);
$client->deviceCredentials->createPublicKey(
    new CreatePublicKeyDeviceCredentialRequestContent([
        'deviceName' => 'device_name',
        'type' => 'public_key',
        'value' => 'value',
        'deviceId' => 'device_id',
    ]),
);

from auth0.management import ManagementClient

client = ManagementClient(
    token="<token>",
)

client.device_credentials.create_public_key(
    device_name="device_name",
    value="value",
    device_id="device_id",
)

require "auth0"

client = Auth0::Management.new(token: "<token>")

client.device_credentials.create_public_key(
  device_name: "device_name",
  type: "public_key",
  value: "value",
  device_id: "device_id"
)

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_name": "<string>",
  "type": "public_key",
  "value": "<string>",
  "device_id": "<string>",
  "client_id": "<string>"
}
'

201

{
  "id": "dcr_0000000000000001"
}

Autorisations

bearerAuthoAuth2ClientCredentials

Authorization · string · header · requis

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

Corps

application/jsonapplication/x-www-form-urlencoded

device_name · string · requis

Name for this device easily recognized by owner.

Minimum string length: 1

type · enum<string> · requis

Type of credential. Must be public_key.

Options disponibles: public_key

value · string · requis

Base64 encoded string containing the credential.

Minimum string length: 1

device_id · string · requis

Unique identifier for the device. Recommend using Android_ID on Android and identifierForVendor.

Maximum string length: 36

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

client_id · string<client-id>

client_id of the client (application) this credential is for.

Réponse

201

application/json

Device credentials successfully created.

id · string · défaut: dcr_0000000000000001 · requis

The credential's identifier