TypeScript

import { ManagementClient } from "auth0";

async function main() {
    const client = new ManagementClient({
        domain: "{YOUR_DOMAIN}",
        token: "<token>",
    });
    await client.users.effectivePermissions.sources.roles.list("id", {
        from: "from",
        take: 1,
        resource_server_identifier: "resource_server_identifier",
        permission_name: "permission_name",
    });
}
main();

import { ManagementClient } from "auth0";

async function main() {
    const client = new ManagementClient({
        domain: "{YOUR_DOMAIN}",
        token: "<token>",
    });
    await client.users.effectivePermissions.sources.roles.list("id", {
        from: "from",
        take: 1,
        resource_server_identifier: "resource_server_identifier",
        permission_name: "permission_name",
    });
}
main();

package example

import (
    context "context"

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

func do() {
    mgmt, err := client.New(
        "{YOUR_DOMAIN}",
        option.WithToken(
            "<token>",
        ),
    )
    if err != nil {
        return
    }
    request := &management.ListUserEffectivePermissionRoleSourceRequestParameters{
        From: management.String(
            "from",
        ),
        Take: management.Int(
            1,
        ),
        ResourceServerIdentifier: "resource_server_identifier",
        PermissionName: "permission_name",
    }
    mgmt.Users.EffectivePermissions.Sources.Roles.List(
        context.TODO(),
        "id",
        request,
    )
}

# Ensure you're logged in: auth0 login
auth0 api get "users/id/effective-permissions/sources/effective-roles" --query "from=from" --query "take=1" --query "resource_server_identifier=resource_server_identifier" --query "permission_name=permission_name"

using Auth0.ManagementApi;
using System.Threading.Tasks;
using Auth0.ManagementApi.Users.EffectivePermissions.Sources;

public partial class Examples
{
    public async Task Example() {
        var client = new ManagementApiClient(
            token: "<token>",
            clientOptions: new ClientOptions { BaseUrl = "https://{YOUR_DOMAIN}/api/v2" }
        );

        await client.Users.EffectivePermissions.Sources.Roles.ListAsync(
            id: "id",
            request: new ListUserEffectivePermissionRoleSourceRequestParameters {
                From = "from",
                Take = 1,
                ResourceServerIdentifier = "resource_server_identifier",
                PermissionName = "permission_name"
            }
        );
    }

}

package com.example.usage;

import com.auth0.client.mgmt.ManagementApi;
import com.auth0.client.mgmt.users.effectivepermissions.sources.types.ListUserEffectivePermissionRoleSourceRequestParameters;

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

        client.users().effectivePermissions().sources().roles().list(
            "id",
            ListUserEffectivePermissionRoleSourceRequestParameters
                .builder()
                .resourceServerIdentifier("resource_server_identifier")
                .permissionName("permission_name")
                .from("from")
                .take(1)
                .build()
        );
    }
}

<?php

namespace Example;

use Auth0\SDK\API\Management\Wrapper\ManagementClient;
use Auth0\SDK\API\Management\Wrapper\ManagementClientOptions;
use Auth0\SDK\API\Management\Users\EffectivePermissions\Sources\Roles\Requests\ListUserEffectivePermissionRoleSourceRequestParameters;

$client = new ManagementClient(new ManagementClientOptions(
    domain: '{YOUR_DOMAIN}',
    token: '<token>',
));
$client->users->effectivePermissions->sources->roles->list(
    'id',
    new ListUserEffectivePermissionRoleSourceRequestParameters([
        'from' => 'from',
        'take' => 1,
        'resourceServerIdentifier' => 'resource_server_identifier',
        'permissionName' => 'permission_name',
    ]),
);

from auth0.management import ManagementClient

client = ManagementClient(
    domain="{YOUR_DOMAIN}",
    token="<token>",
)

client.users.effective_permissions.sources.roles.list(
    id="id",
    from_="from",
    take=1,
    resource_server_identifier="resource_server_identifier",
    permission_name="permission_name",
)

require "auth0"

client = Auth0::Management.new(token: "<token>", base_url: "https://{YOUR_DOMAIN}/api/v2")

client.users.effective_permissions.sources.roles.list(
  id: "id",
  from: "from",
  take: 1,
  resource_server_identifier: "resource_server_identifier",
  permission_name: "permission_name"
)

{
  "roles": [
    {
      "id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "type": "tenant",
      "owner_id": "<string>",
      "sources": [
        "direct"
      ]
    }
  ],
  "next": "<string>"
}

指定した権限をユーザーに付与するロールを一覧表示します（直接付与されたものと、グループ経由のものを含みます）。

ユーザーに直接割り当てられたロールと、グループメンバーシップを通じて継承されたロールを含め、指定された権限をユーザーに付与するロールの一覧を返します。

GET

https://{tenantDomain}/api/v2

users

{id}

effective-permissions

sources

effective-roles

TypeScript

import { ManagementClient } from "auth0";

async function main() {
    const client = new ManagementClient({
        domain: "{YOUR_DOMAIN}",
        token: "<token>",
    });
    await client.users.effectivePermissions.sources.roles.list("id", {
        from: "from",
        take: 1,
        resource_server_identifier: "resource_server_identifier",
        permission_name: "permission_name",
    });
}
main();

import { ManagementClient } from "auth0";

async function main() {
    const client = new ManagementClient({
        domain: "{YOUR_DOMAIN}",
        token: "<token>",
    });
    await client.users.effectivePermissions.sources.roles.list("id", {
        from: "from",
        take: 1,
        resource_server_identifier: "resource_server_identifier",
        permission_name: "permission_name",
    });
}
main();

package example

import (
    context "context"

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

func do() {
    mgmt, err := client.New(
        "{YOUR_DOMAIN}",
        option.WithToken(
            "<token>",
        ),
    )
    if err != nil {
        return
    }
    request := &management.ListUserEffectivePermissionRoleSourceRequestParameters{
        From: management.String(
            "from",
        ),
        Take: management.Int(
            1,
        ),
        ResourceServerIdentifier: "resource_server_identifier",
        PermissionName: "permission_name",
    }
    mgmt.Users.EffectivePermissions.Sources.Roles.List(
        context.TODO(),
        "id",
        request,
    )
}

# Ensure you're logged in: auth0 login
auth0 api get "users/id/effective-permissions/sources/effective-roles" --query "from=from" --query "take=1" --query "resource_server_identifier=resource_server_identifier" --query "permission_name=permission_name"

using Auth0.ManagementApi;
using System.Threading.Tasks;
using Auth0.ManagementApi.Users.EffectivePermissions.Sources;

public partial class Examples
{
    public async Task Example() {
        var client = new ManagementApiClient(
            token: "<token>",
            clientOptions: new ClientOptions { BaseUrl = "https://{YOUR_DOMAIN}/api/v2" }
        );

        await client.Users.EffectivePermissions.Sources.Roles.ListAsync(
            id: "id",
            request: new ListUserEffectivePermissionRoleSourceRequestParameters {
                From = "from",
                Take = 1,
                ResourceServerIdentifier = "resource_server_identifier",
                PermissionName = "permission_name"
            }
        );
    }

}

package com.example.usage;

import com.auth0.client.mgmt.ManagementApi;
import com.auth0.client.mgmt.users.effectivepermissions.sources.types.ListUserEffectivePermissionRoleSourceRequestParameters;

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

        client.users().effectivePermissions().sources().roles().list(
            "id",
            ListUserEffectivePermissionRoleSourceRequestParameters
                .builder()
                .resourceServerIdentifier("resource_server_identifier")
                .permissionName("permission_name")
                .from("from")
                .take(1)
                .build()
        );
    }
}

<?php

namespace Example;

use Auth0\SDK\API\Management\Wrapper\ManagementClient;
use Auth0\SDK\API\Management\Wrapper\ManagementClientOptions;
use Auth0\SDK\API\Management\Users\EffectivePermissions\Sources\Roles\Requests\ListUserEffectivePermissionRoleSourceRequestParameters;

$client = new ManagementClient(new ManagementClientOptions(
    domain: '{YOUR_DOMAIN}',
    token: '<token>',
));
$client->users->effectivePermissions->sources->roles->list(
    'id',
    new ListUserEffectivePermissionRoleSourceRequestParameters([
        'from' => 'from',
        'take' => 1,
        'resourceServerIdentifier' => 'resource_server_identifier',
        'permissionName' => 'permission_name',
    ]),
);

from auth0.management import ManagementClient

client = ManagementClient(
    domain="{YOUR_DOMAIN}",
    token="<token>",
)

client.users.effective_permissions.sources.roles.list(
    id="id",
    from_="from",
    take=1,
    resource_server_identifier="resource_server_identifier",
    permission_name="permission_name",
)

require "auth0"

client = Auth0::Management.new(token: "<token>", base_url: "https://{YOUR_DOMAIN}/api/v2")

client.users.effective_permissions.sources.roles.list(
  id: "id",
  from: "from",
  take: 1,
  resource_server_identifier: "resource_server_identifier",
  permission_name: "permission_name"
)

{
  "roles": [
    {
      "id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "type": "tenant",
      "owner_id": "<string>",
      "sources": [
        "direct"
      ]
    }
  ],
  "next": "<string>"
}

承認

Authorization

string

header

必須

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

パスパラメータ

string

必須

権限を取得する対象ユーザーの ID。

クエリパラメータ

from

string

一覧の開始位置を示す省略可能な ID。

take

integer

1 ページあたりの結果数。デフォルトは 50 です。

必須範囲: x >= 1

resource_server_identifier

string

必須

ユーザー権限の計算対象となるリソースサーバーの識別子。

Required string length: 1 - 600

permission_name

string

必須

この権限の名前

Required string length: 1 - 280

レスポンス

ユーザーの実効権限のロールソースが正常に取得されました。

roles

object[]

必須

指定された権限が割り当てられているユーザーのロール。直接割り当てられたものと、グループ経由のものの両方を含みます。

Show child attributes

string

結果の次のページで "from" クエリパラメータとして使用するカーソル。