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"
}

承認

bearerAuthoAuth2ClientCredentials

Authorization · string · header · 必須

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

ボディ

application/jsonapplication/x-www-form-urlencoded

device_name · string · 必須

Name for this device easily recognized by owner.

Minimum string length: 1

type · enum<string> · 必須

Type of credential. Must be public_key.

利用可能なオプション: public_key

value · string · 必須

Base64 encoded string containing the credential.

Minimum string length: 1

device_id · string · 必須

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.

レスポンス

201

application/json

Device credentials successfully created.

id · string · デフォルト: dcr_0000000000000001 · 必須

The credential's identifier