次の方法で共有


@azure/ms-rest-nodeauth package

クラス

ApplicationTokenCertificateCredentials
ApplicationTokenCredentials
AzureCliCredentials

Azure CLI を使用してトークンを取得することで、資格情報について説明します。

DeviceTokenCredentials
MSIAppServiceTokenCredentials

App Service 環境でのマネージド サービス ID トークンの資格情報に関する情報を提供します。

MSITokenCredentials

マネージド サービス ID トークンの資格情報に関する情報を提供します。 このオブジェクトは、マネージド サービス ID を使用して Azure にプロビジョニングされた仮想マシン上のトークンを取得するためにのみ使用できます。

MSIVmTokenCredentials

Azure でプロビジョニングされた仮想マシン上のマネージド サービス ID トークン資格情報に関する情報を提供します。

TokenCredentialsBase
UserTokenCredentials

インターフェイス

AuthResponse

認証応答について説明します。

AzureTokenCredentialsOptions

servicePrincipal/secret 認証の省略可能なパラメーターについて説明します。

CliAccessToken

Azure CLI から取得したアクセス トークンについて説明します。

InteractiveLoginOptions

対話型認証の省略可能なパラメーターについて説明します。

LinkedSubscription

認証プロセス中に見つかったサブスクリプションに関する情報を提供します。 この型の構造は、ResourceManager API への要求を行うことによって取得されるサブスクリプション オブジェクトとは異なります。

LinkedUser

認証の観点からユーザーに関する情報を提供します。

ListAllSubscriptionOptions

Azure CLI を使用してすべてのサブスクリプション/アカウントを一覧表示するときに指定できるオプションについて説明します。

LoginWithAuthFileOptions

AuthFile を使用したログインの省略可能なパラメーターについて説明します。

LoginWithUsernamePasswordOptions

ユーザー名/パスワード認証の省略可能なパラメーターについて説明します。

MSIAppServiceOptions

AppService の MSI を使用した認証の省略可能なパラメーターを定義します。

MSIOptions

MSI を使用した認証の省略可能なパラメーターを定義します。

MSITokenResponse

MSITokenResponse について説明します。

MSIVmOptions

仮想マシンの MSI を使用した認証の省略可能なパラメーターを定義します。

型エイリアス

TokenAudience
UserType

ユーザーの種類に関する情報を提供します。 現在、"user" または "servicePrincipal" にすることができます。

関数

buildTenantList(TokenCredentialsBase, string)

tenantIds の配列を構築します。

createAuthenticator(MSITokenCredentials)
interactiveLogin()

ブラウザーにコピーして貼り付け、その上で認証する必要がある URL とコードを提供します。 成功した場合、ユーザーは DeviceTokenCredentials オブジェクトと、該当するすべてのテナントにわたってその userId に関連付けられているサブスクリプションの一覧を取得します。

個人用アカウントを使用する場合は、domain パラメーターの options プロパティを、そのアカウントのテナントの ID に設定する必要があります。 それ以外の場合、結果の資格情報はアカウントのリソースにアクセスできません。

interactiveLogin(InteractiveLoginOptions)
interactiveLogin(InteractiveLoginOptions, (err: Error, credentials: DeviceTokenCredentials, subscriptions: LinkedSubscription[]) => void)
interactiveLogin(any)
interactiveLoginWithAuthResponse(InteractiveLoginOptions)

ブラウザーにコピーして貼り付け、その上で認証する必要がある URL とコードを提供します。 成功した場合、ユーザーは DeviceTokenCredentials オブジェクトと、該当するすべてのテナントにわたってその userId に関連付けられているサブスクリプションの一覧を取得します。

個人用アカウントを使用する場合は、domain パラメーターの options プロパティを、そのアカウントのテナントの ID に設定する必要があります。 それ以外の場合、結果の資格情報はアカウントのリソースにアクセスできません。

loginWithAppServiceMSI()

App Service MSI を使用して認証します。

loginWithAppServiceMSI(MSIAppServiceOptions)
loginWithAppServiceMSI(MSIAppServiceOptions, Callback<MSIAppServiceTokenCredentials>)
loginWithAppServiceMSI(Callback<MSIAppServiceTokenCredentials>)
loginWithAuthFile()

この方法を使用する前に、https://github.com/Azure/azure-cli/releasesから az cli をインストールしてください。 次に、az ad sp create-for-rbac --sdk-auth > ${yourFilename.json}を実行します。 別のクラウド/環境用に sp を作成する場合は、次を実行してください。

  1. az クラウド リスト
  2. az cloud set –n <環境の名前>
  3. az ad sp create-for-rbac --sdk-auth > auth.json // シークレットを使用して SP を作成する OR
  4. az ad sp create-for-rbac --create-cert --sdk-auth > auth.json // create sp with certificate (サービス プリンシパルが既に作成されている場合)、サービス プリンシパル情報を使用してログインします。
  5. az login --service-principal -u < clientId> -p <clientSecret> -t <tenantId>
  6. AZ account Show --SDK-auth > auth.json

認証ファイルで指定されたサービス プリンシパル情報を使用して認証します。 このメソッドは、認証ファイルの subscriptionId を options パラメーターまたは既定の "AZURE_SUBSCRIPTION_ID" でユーザーが指定した環境変数に設定します。

loginWithAuthFile(LoginWithAuthFileOptions)
loginWithAuthFile(LoginWithAuthFileOptions, (err: Error, credentials: ApplicationTokenCredentials | ApplicationTokenCertificateCredentials, subscriptions: LinkedSubscription[]) => void)
loginWithAuthFile(any)
loginWithAuthFileWithAuthResponse(LoginWithAuthFileOptions)

この方法を使用する前に、https://github.com/Azure/azure-cli/releasesから az cli をインストールしてください。 次に、az ad sp create-for-rbac --sdk-auth > ${yourFilename.json}を実行します。 別のクラウド/環境用に sp を作成する場合は、次を実行してください。

  1. az クラウド リスト
  2. az cloud set –n <環境の名前>
  3. az ad sp create-for-rbac --sdk-auth > auth.json // シークレットを使用して SP を作成する OR
  4. az ad sp create-for-rbac --create-cert --sdk-auth > auth.json // create sp with certificate (サービス プリンシパルが既に作成されている場合)、サービス プリンシパル情報を使用してログインします。
  5. az login --service-principal -u < clientId> -p <clientSecret> -t <tenantId>
  6. AZ account Show --SDK-auth > auth.json

認証ファイルで指定されたサービス プリンシパル情報を使用して認証します。 このメソッドは、認証ファイルの subscriptionId を options パラメーターまたは既定の "AZURE_SUBSCRIPTION_ID" でユーザーが指定した環境変数に設定します。

loginWithServicePrincipalCertificate(string, string, string)

ApplicationTokenCertificateCredentials オブジェクトと、該当するすべてのテナントにわたって、その servicePrincipalId/clientId に関連付けられているサブスクリプションの一覧を提供します。

個人用アカウントを使用する場合、domain パラメーターには、そのアカウントのテナントの ID を設定する必要があります。 それ以外の場合、結果の資格情報はアカウントのリソースにアクセスできません。

loginWithServicePrincipalCertificate(string, string, string, AzureTokenCredentialsOptions)
loginWithServicePrincipalCertificate(string, string, string, AzureTokenCredentialsOptions, (err: Error, credentials: ApplicationTokenCertificateCredentials, subscriptions: LinkedSubscription[]) => void)
loginWithServicePrincipalCertificate(string, string, string, any)
loginWithServicePrincipalCertificateWithAuthResponse(string, string, string, AzureTokenCredentialsOptions)

ApplicationTokenCertificateCredentials オブジェクトと、該当するすべてのテナントにわたって、その servicePrincipalId/clientId に関連付けられているサブスクリプションの一覧を提供します。

個人用アカウントを使用する場合、domain パラメーターには、そのアカウントのテナントの ID を設定する必要があります。 それ以外の場合、結果の資格情報はアカウントのリソースにアクセスできません。

loginWithServicePrincipalSecret(string, string, string)

ApplicationTokenCredentials オブジェクトと、該当するすべてのテナントにわたって、その servicePrincipalId/clientId に関連付けられているサブスクリプションの一覧を提供します。

個人用アカウントを使用する場合、domain パラメーターには、そのアカウントのテナントの ID を設定する必要があります。 それ以外の場合、結果の資格情報はアカウントのリソースにアクセスできません。

loginWithServicePrincipalSecret(string, string, string, AzureTokenCredentialsOptions)
loginWithServicePrincipalSecret(string, string, string, AzureTokenCredentialsOptions, (err: Error, credentials: ApplicationTokenCredentials, subscriptions: LinkedSubscription[]) => void)
loginWithServicePrincipalSecret(string, string, string, any)
loginWithServicePrincipalSecretWithAuthResponse(string, string, string, AzureTokenCredentialsOptions)

ApplicationTokenCredentials オブジェクトと、該当するすべてのテナントにわたって、その servicePrincipalId/clientId に関連付けられているサブスクリプションの一覧を提供します。

個人用アカウントを使用する場合、domain パラメーターには、そのアカウントのテナントの ID を設定する必要があります。 それ以外の場合、結果の資格情報はアカウントのリソースにアクセスできません。

loginWithUsernamePassword(string, string)

UserTokenCredentials オブジェクトと、該当するすべてのテナントにわたってその userId に関連付けられているサブスクリプションの一覧を提供します。

この方法は、2FA が有効になっていない組織 ID にのみ適用されます。それ以外の場合は、対話型ログインを使用してください。

個人用アカウントを使用する場合は、domain パラメーターの options プロパティを、そのアカウントのテナントの ID に設定する必要があります。 それ以外の場合、結果の資格情報はアカウントのリソースにアクセスできません。

loginWithUsernamePassword(string, string, LoginWithUsernamePasswordOptions)
loginWithUsernamePassword(string, string, any)
loginWithUsernamePassword(string, string, LoginWithUsernamePasswordOptions, (err: Error, credentials: UserTokenCredentials, subscriptions: LinkedSubscription[]) => void)
loginWithUsernamePasswordWithAuthResponse(string, string, LoginWithUsernamePasswordOptions)

UserTokenCredentials オブジェクトと、該当するすべてのテナントにわたってその userId に関連付けられているサブスクリプションの一覧を提供します。 この方法は、2FA が有効になっていない組織 ID にのみ適用されます。それ以外の場合は、対話型ログインを使用してください。

個人用アカウントを使用する場合は、domain パラメーターの options プロパティを、そのアカウントのテナントの ID に設定する必要があります。 それ以外の場合、結果の資格情報はアカウントのリソースにアクセスできません。

loginWithVmMSI()

この方法を使用する前に、https://github.com/Azure/azure-cli/releasesから az cli をインストールしてください。 az cli でプロビジョニングされた Azure 仮想マシンがあり、MSI が有効になっている場合は、この方法を使用して VM から認証トークンを取得できます。

新しい VM を作成するには、MSI を有効にして、次のコマンドを実行してください。az vm create -g <resource_group_name> -n <vm_name> --assign-identity --image <os_image_name> 注: 上記のコマンドでは、既定のポート 50342 でホスト上のサービス エンドポイントが有効になります

既にプロビジョニングされている VM で MSI を有効にするには、次のコマンドを実行します。az vm --assign-identity -g <resource_group_name> -n <vm_name> --port <custom_port_number>

このコマンドの詳細については、az vm --assign-identity -h を実行してください。

Azure 仮想マシンで実行されている ID サービスを使用して認証します。 このメソッドは、VM でホストされている認証サービスに要求を行い、アクセス トークンを取得します。

loginWithVmMSI(MSIVmOptions)
loginWithVmMSI(MSIVmOptions, Callback<MSIVmTokenCredentials>)
loginWithVmMSI(Callback<MSIVmTokenCredentials>)

変数

AuthConstants

関数の詳細

buildTenantList(TokenCredentialsBase, string)

tenantIds の配列を構築します。

function buildTenantList(credentials: TokenCredentialsBase, apiVersion?: string): Promise<string[]>

パラメーター

credentials
TokenCredentialsBase

資格情報。

apiVersion

string

既定値 2016-06-01

戻り値

Promise<string[]>

tenantIds の配列に解決され、エラーで拒否される Promise。

createAuthenticator(MSITokenCredentials)

function createAuthenticator(credentials: MSITokenCredentials): Authenticator

パラメーター

credentials
MSITokenCredentials

戻り値

interactiveLogin()

ブラウザーにコピーして貼り付け、その上で認証する必要がある URL とコードを提供します。 成功した場合、ユーザーは DeviceTokenCredentials オブジェクトと、該当するすべてのテナントにわたってその userId に関連付けられているサブスクリプションの一覧を取得します。

個人用アカウントを使用する場合は、domain パラメーターの options プロパティを、そのアカウントのテナントの ID に設定する必要があります。 それ以外の場合、結果の資格情報はアカウントのリソースにアクセスできません。

function interactiveLogin(): Promise<DeviceTokenCredentials>

戻り値

コールバックが最後のパラメーターとして渡された場合、void を返します。それ以外の場合は Promise を返します。 コールバックは、結果として得られる DeviceTokenCredentials オブジェクトと、該当するすべてのテナントに関連するサブスクリプションの一覧を使用して呼び出されます。

interactiveLogin(InteractiveLoginOptions)

function interactiveLogin(options: InteractiveLoginOptions): Promise<DeviceTokenCredentials>

パラメーター

戻り値

interactiveLogin(InteractiveLoginOptions, (err: Error, credentials: DeviceTokenCredentials, subscriptions: LinkedSubscription[]) => void)

function interactiveLogin(options: InteractiveLoginOptions, callback: (err: Error, credentials: DeviceTokenCredentials, subscriptions: LinkedSubscription[]) => void)

パラメーター

callback

(err: Error, credentials: DeviceTokenCredentials, subscriptions: LinkedSubscription[]) => void

interactiveLogin(any)

function interactiveLogin(callback: any)

パラメーター

callback

any

interactiveLoginWithAuthResponse(InteractiveLoginOptions)

ブラウザーにコピーして貼り付け、その上で認証する必要がある URL とコードを提供します。 成功した場合、ユーザーは DeviceTokenCredentials オブジェクトと、該当するすべてのテナントにわたってその userId に関連付けられているサブスクリプションの一覧を取得します。

個人用アカウントを使用する場合は、domain パラメーターの options プロパティを、そのアカウントのテナントの ID に設定する必要があります。 それ以外の場合、結果の資格情報はアカウントのリソースにアクセスできません。

function interactiveLoginWithAuthResponse(options?: InteractiveLoginOptions): Promise<AuthResponse<DeviceTokenCredentials>>

パラメーター

options
InteractiveLoginOptions

省略可能なパラメーターを表すオブジェクト。

戻り値

AuthResponse に解決され、"資格情報" 配列とオプションの "サブスクリプション" 配列が含まれ、エラーで拒否される Promise。

loginWithAppServiceMSI()

App Service MSI を使用して認証します。

function loginWithAppServiceMSI(): Promise<MSIAppServiceTokenCredentials>

戻り値

コールバックが最後のパラメーターとして渡された場合、void を返します。それ以外の場合は Promise を返します。 結果の MSIAppServiceTokenCredentials オブジェクトを使用してコールバックが呼び出されます。

loginWithAppServiceMSI(MSIAppServiceOptions)

function loginWithAppServiceMSI(options: MSIAppServiceOptions): Promise<MSIAppServiceTokenCredentials>

パラメーター

戻り値

loginWithAppServiceMSI(MSIAppServiceOptions, Callback<MSIAppServiceTokenCredentials>)

function loginWithAppServiceMSI(options: MSIAppServiceOptions, callback: Callback<MSIAppServiceTokenCredentials>)

パラメーター

callback

Callback<MSIAppServiceTokenCredentials>

loginWithAppServiceMSI(Callback<MSIAppServiceTokenCredentials>)

function loginWithAppServiceMSI(callback: Callback<MSIAppServiceTokenCredentials>)

パラメーター

callback

Callback<MSIAppServiceTokenCredentials>

loginWithAuthFile()

この方法を使用する前に、https://github.com/Azure/azure-cli/releasesから az cli をインストールしてください。 次に、az ad sp create-for-rbac --sdk-auth > ${yourFilename.json}を実行します。 別のクラウド/環境用に sp を作成する場合は、次を実行してください。

  1. az クラウド リスト
  2. az cloud set –n <環境の名前>
  3. az ad sp create-for-rbac --sdk-auth > auth.json // シークレットを使用して SP を作成する OR
  4. az ad sp create-for-rbac --create-cert --sdk-auth > auth.json // create sp with certificate (サービス プリンシパルが既に作成されている場合)、サービス プリンシパル情報を使用してログインします。
  5. az login --service-principal -u < clientId> -p <clientSecret> -t <tenantId>
  6. AZ account Show --SDK-auth > auth.json

認証ファイルで指定されたサービス プリンシパル情報を使用して認証します。 このメソッドは、認証ファイルの subscriptionId を options パラメーターまたは既定の "AZURE_SUBSCRIPTION_ID" でユーザーが指定した環境変数に設定します。

function loginWithAuthFile(): Promise<ApplicationTokenCredentials | ApplicationTokenCertificateCredentials>

戻り値

コールバックが最後のパラメーターとして渡された場合、void を返します。それ以外の場合は Promise を返します。 コールバックは、結果として得られる ApplicationTokenCredentials オブジェクトまたは ApplicationTokenCertificateCredentials オブジェクトと、該当するすべてのテナントにわたって関連付けられているサブスクリプションの一覧を使用して呼び出されます。

loginWithAuthFile(LoginWithAuthFileOptions)

function loginWithAuthFile(options: LoginWithAuthFileOptions): Promise<ApplicationTokenCredentials | ApplicationTokenCertificateCredentials>

パラメーター

戻り値

loginWithAuthFile(LoginWithAuthFileOptions, (err: Error, credentials: ApplicationTokenCredentials | ApplicationTokenCertificateCredentials, subscriptions: LinkedSubscription[]) => void)

function loginWithAuthFile(options: LoginWithAuthFileOptions, callback: (err: Error, credentials: ApplicationTokenCredentials | ApplicationTokenCertificateCredentials, subscriptions: LinkedSubscription[]) => void)

パラメーター

callback

(err: Error, credentials: ApplicationTokenCredentials | ApplicationTokenCertificateCredentials, subscriptions: LinkedSubscription[]) => void

loginWithAuthFile(any)

function loginWithAuthFile(callback: any)

パラメーター

callback

any

loginWithAuthFileWithAuthResponse(LoginWithAuthFileOptions)

この方法を使用する前に、https://github.com/Azure/azure-cli/releasesから az cli をインストールしてください。 次に、az ad sp create-for-rbac --sdk-auth > ${yourFilename.json}を実行します。 別のクラウド/環境用に sp を作成する場合は、次を実行してください。

  1. az クラウド リスト
  2. az cloud set –n <環境の名前>
  3. az ad sp create-for-rbac --sdk-auth > auth.json // シークレットを使用して SP を作成する OR
  4. az ad sp create-for-rbac --create-cert --sdk-auth > auth.json // create sp with certificate (サービス プリンシパルが既に作成されている場合)、サービス プリンシパル情報を使用してログインします。
  5. az login --service-principal -u < clientId> -p <clientSecret> -t <tenantId>
  6. AZ account Show --SDK-auth > auth.json

認証ファイルで指定されたサービス プリンシパル情報を使用して認証します。 このメソッドは、認証ファイルの subscriptionId を options パラメーターまたは既定の "AZURE_SUBSCRIPTION_ID" でユーザーが指定した環境変数に設定します。

function loginWithAuthFileWithAuthResponse(options?: LoginWithAuthFileOptions): Promise<AuthResponse<ApplicationTokenCredentials | ApplicationTokenCertificateCredentials>>

パラメーター

options
LoginWithAuthFileOptions

省略可能なパラメーター

戻り値

AuthResponse に解決され、"資格情報" 配列とオプションの "サブスクリプション" 配列が含まれ、エラーで拒否される Promise。

loginWithServicePrincipalCertificate(string, string, string)

ApplicationTokenCertificateCredentials オブジェクトと、該当するすべてのテナントにわたって、その servicePrincipalId/clientId に関連付けられているサブスクリプションの一覧を提供します。

個人用アカウントを使用する場合、domain パラメーターには、そのアカウントのテナントの ID を設定する必要があります。 それ以外の場合、結果の資格情報はアカウントのリソースにアクセスできません。

function loginWithServicePrincipalCertificate(clientId: string, certificateStringOrFilePath: string, domain: string): Promise<ApplicationTokenCertificateCredentials>

パラメーター

clientId

string

ACTIVE Directory アプリケーション クライアント ID は SPN (ServicePrincipal 名) とも呼ばれます。 例については、「Active Directory クイック スタート for .Net」を参照してください。

certificateStringOrFilePath

string

PEM でエンコードされた証明書と秘密キー、またはその情報を含む .pem ファイルへの絶対ファイルパス。 例えば:

  • CertificateString: "-----BEGIN PRIVATE KEY-----\n<XXXXX>\n-----END PRIVATE KEY-----\n-----BEGIN CERTIFICATE-----\n<yyy>\n-----END CERTIFICATE-----\n"
  • CertificateFilePath: .pem ファイルの絶対 ファイル パスを します。
domain

string

このアプリケーションを含むドメインまたはテナント ID。

戻り値

コールバックが最後のパラメーターとして渡された場合、void を返します。それ以外の場合は Promise を返します。 コールバックは、結果として得られる ApplicationTokenCertificateCredentials オブジェクトと、該当するすべてのテナントに関連するサブスクリプションの一覧を使用して呼び出されます。

loginWithServicePrincipalCertificate(string, string, string, AzureTokenCredentialsOptions)

function loginWithServicePrincipalCertificate(clientId: string, certificateStringOrFilePath: string, domain: string, options: AzureTokenCredentialsOptions): Promise<ApplicationTokenCertificateCredentials>

パラメーター

clientId

string

certificateStringOrFilePath

string

domain

string

戻り値

loginWithServicePrincipalCertificate(string, string, string, AzureTokenCredentialsOptions, (err: Error, credentials: ApplicationTokenCertificateCredentials, subscriptions: LinkedSubscription[]) => void)

function loginWithServicePrincipalCertificate(clientId: string, certificateStringOrFilePath: string, domain: string, options: AzureTokenCredentialsOptions, callback: (err: Error, credentials: ApplicationTokenCertificateCredentials, subscriptions: LinkedSubscription[]) => void)

パラメーター

clientId

string

certificateStringOrFilePath

string

domain

string

callback

(err: Error, credentials: ApplicationTokenCertificateCredentials, subscriptions: LinkedSubscription[]) => void

loginWithServicePrincipalCertificate(string, string, string, any)

function loginWithServicePrincipalCertificate(clientId: string, certificateStringOrFilePath: string, domain: string, callback: any)

パラメーター

clientId

string

certificateStringOrFilePath

string

domain

string

callback

any

loginWithServicePrincipalCertificateWithAuthResponse(string, string, string, AzureTokenCredentialsOptions)

ApplicationTokenCertificateCredentials オブジェクトと、該当するすべてのテナントにわたって、その servicePrincipalId/clientId に関連付けられているサブスクリプションの一覧を提供します。

個人用アカウントを使用する場合、domain パラメーターには、そのアカウントのテナントの ID を設定する必要があります。 それ以外の場合、結果の資格情報はアカウントのリソースにアクセスできません。

function loginWithServicePrincipalCertificateWithAuthResponse(clientId: string, certificateStringOrFilePath: string, domain: string, options?: AzureTokenCredentialsOptions): Promise<AuthResponse<ApplicationTokenCertificateCredentials>>

パラメーター

clientId

string

ACTIVE Directory アプリケーション クライアント ID は SPN (ServicePrincipal 名) とも呼ばれます。 例については、「Active Directory クイック スタート for .Net」を参照してください。

certificateStringOrFilePath

string

PEM でエンコードされた証明書と秘密キー、またはその情報を含む .pem ファイルへの絶対ファイルパス。 例えば:

  • CertificateString: "-----BEGIN PRIVATE KEY-----\n<XXXXX>\n-----END PRIVATE KEY-----\n-----BEGIN CERTIFICATE-----\n<yyy>\n-----END CERTIFICATE-----\n"
  • CertificateFilePath: .pem ファイルの絶対 ファイル パスを します。
domain

string

このアプリケーションを含むドメインまたはテナント ID。

options
AzureTokenCredentialsOptions

省略可能なパラメーターを表すオブジェクト。

戻り値

AuthResponse に解決され、"資格情報" 配列とオプションの "サブスクリプション" 配列が含まれ、エラーで拒否される Promise。

loginWithServicePrincipalSecret(string, string, string)

ApplicationTokenCredentials オブジェクトと、該当するすべてのテナントにわたって、その servicePrincipalId/clientId に関連付けられているサブスクリプションの一覧を提供します。

個人用アカウントを使用する場合、domain パラメーターには、そのアカウントのテナントの ID を設定する必要があります。 それ以外の場合、結果の資格情報はアカウントのリソースにアクセスできません。

function loginWithServicePrincipalSecret(clientId: string, secret: string, domain: string): Promise<ApplicationTokenCredentials>

パラメーター

clientId

string

ACTIVE Directory アプリケーション クライアント ID は SPN (ServicePrincipal 名) とも呼ばれます。 例については、「Active Directory クイック スタート for .Net」を参照してください。

secret

string

サービス プリンシパルのアプリケーション シークレット。

domain

string

このアプリケーションを含むドメインまたはテナント ID。

戻り値

コールバックが最後のパラメーターとして渡された場合、void を返します。それ以外の場合は Promise を返します。 コールバックは、結果として得られる ApplicationTokenCredentials オブジェクトと、該当するすべてのテナントに関連するサブスクリプションの一覧を使用して呼び出されます。

loginWithServicePrincipalSecret(string, string, string, AzureTokenCredentialsOptions)

function loginWithServicePrincipalSecret(clientId: string, secret: string, domain: string, options: AzureTokenCredentialsOptions): Promise<ApplicationTokenCredentials>

パラメーター

clientId

string

secret

string

domain

string

戻り値

loginWithServicePrincipalSecret(string, string, string, AzureTokenCredentialsOptions, (err: Error, credentials: ApplicationTokenCredentials, subscriptions: LinkedSubscription[]) => void)

function loginWithServicePrincipalSecret(clientId: string, secret: string, domain: string, options: AzureTokenCredentialsOptions, callback: (err: Error, credentials: ApplicationTokenCredentials, subscriptions: LinkedSubscription[]) => void)

パラメーター

clientId

string

secret

string

domain

string

callback

(err: Error, credentials: ApplicationTokenCredentials, subscriptions: LinkedSubscription[]) => void

loginWithServicePrincipalSecret(string, string, string, any)

function loginWithServicePrincipalSecret(clientId: string, secret: string, domain: string, callback: any)

パラメーター

clientId

string

secret

string

domain

string

callback

any

loginWithServicePrincipalSecretWithAuthResponse(string, string, string, AzureTokenCredentialsOptions)

ApplicationTokenCredentials オブジェクトと、該当するすべてのテナントにわたって、その servicePrincipalId/clientId に関連付けられているサブスクリプションの一覧を提供します。

個人用アカウントを使用する場合、domain パラメーターには、そのアカウントのテナントの ID を設定する必要があります。 それ以外の場合、結果の資格情報はアカウントのリソースにアクセスできません。

function loginWithServicePrincipalSecretWithAuthResponse(clientId: string, secret: string, domain: string, options?: AzureTokenCredentialsOptions): Promise<AuthResponse<ApplicationTokenCredentials>>

パラメーター

clientId

string

ACTIVE Directory アプリケーション クライアント ID は SPN (ServicePrincipal 名) とも呼ばれます。 例については、「Active Directory クイック スタート for .Net」を参照してください。

secret

string

サービス プリンシパルのアプリケーション シークレット。

domain

string

このアプリケーションを含むドメインまたはテナント ID。

options
AzureTokenCredentialsOptions

省略可能なパラメーターを表すオブジェクト。

戻り値

AuthResponse に解決され、"資格情報" 配列とオプションの "サブスクリプション" 配列が含まれ、エラーで拒否される Promise。

loginWithUsernamePassword(string, string)

UserTokenCredentials オブジェクトと、該当するすべてのテナントにわたってその userId に関連付けられているサブスクリプションの一覧を提供します。

この方法は、2FA が有効になっていない組織 ID にのみ適用されます。それ以外の場合は、対話型ログインを使用してください。

個人用アカウントを使用する場合は、domain パラメーターの options プロパティを、そのアカウントのテナントの ID に設定する必要があります。 それ以外の場合、結果の資格情報はアカウントのリソースにアクセスできません。

function loginWithUsernamePassword(username: string, password: string): Promise<UserTokenCredentials>

パラメーター

username

string

組織 ID アカウントのユーザー名。

password

string

組織 ID アカウントのパスワード。

戻り値

コールバックが最後のパラメーターとして渡された場合、void を返します。それ以外の場合は Promise を返します。 コールバックは、結果として得られる UserTokenCredentials オブジェクトと、該当するすべてのテナントに関連するサブスクリプションの一覧を使用して呼び出されます。

loginWithUsernamePassword(string, string, LoginWithUsernamePasswordOptions)

function loginWithUsernamePassword(username: string, password: string, options: LoginWithUsernamePasswordOptions): Promise<UserTokenCredentials>

パラメーター

username

string

password

string

戻り値

loginWithUsernamePassword(string, string, any)

function loginWithUsernamePassword(username: string, password: string, callback: any)

パラメーター

username

string

password

string

callback

any

loginWithUsernamePassword(string, string, LoginWithUsernamePasswordOptions, (err: Error, credentials: UserTokenCredentials, subscriptions: LinkedSubscription[]) => void)

function loginWithUsernamePassword(username: string, password: string, options: LoginWithUsernamePasswordOptions, callback: (err: Error, credentials: UserTokenCredentials, subscriptions: LinkedSubscription[]) => void)

パラメーター

username

string

password

string

callback

(err: Error, credentials: UserTokenCredentials, subscriptions: LinkedSubscription[]) => void

loginWithUsernamePasswordWithAuthResponse(string, string, LoginWithUsernamePasswordOptions)

UserTokenCredentials オブジェクトと、該当するすべてのテナントにわたってその userId に関連付けられているサブスクリプションの一覧を提供します。 この方法は、2FA が有効になっていない組織 ID にのみ適用されます。それ以外の場合は、対話型ログインを使用してください。

個人用アカウントを使用する場合は、domain パラメーターの options プロパティを、そのアカウントのテナントの ID に設定する必要があります。 それ以外の場合、結果の資格情報はアカウントのリソースにアクセスできません。

function loginWithUsernamePasswordWithAuthResponse(username: string, password: string, options?: LoginWithUsernamePasswordOptions): Promise<AuthResponse<UserTokenCredentials>>

パラメーター

username

string

組織 ID アカウントのユーザー名。

password

string

組織 ID アカウントのパスワード。

options
LoginWithUsernamePasswordOptions

省略可能なパラメーターを表すオブジェクト。

戻り値

credentials と省略可能な subscriptions 配列を含む AuthResponse に解決され、エラーで拒否される Promise。

loginWithVmMSI()

この方法を使用する前に、https://github.com/Azure/azure-cli/releasesから az cli をインストールしてください。 az cli でプロビジョニングされた Azure 仮想マシンがあり、MSI が有効になっている場合は、この方法を使用して VM から認証トークンを取得できます。

新しい VM を作成するには、MSI を有効にして、次のコマンドを実行してください。az vm create -g <resource_group_name> -n <vm_name> --assign-identity --image <os_image_name> 注: 上記のコマンドでは、既定のポート 50342 でホスト上のサービス エンドポイントが有効になります

既にプロビジョニングされている VM で MSI を有効にするには、次のコマンドを実行します。az vm --assign-identity -g <resource_group_name> -n <vm_name> --port <custom_port_number>

このコマンドの詳細については、az vm --assign-identity -h を実行してください。

Azure 仮想マシンで実行されている ID サービスを使用して認証します。 このメソッドは、VM でホストされている認証サービスに要求を行い、アクセス トークンを取得します。

function loginWithVmMSI(): Promise<MSIVmTokenCredentials>

戻り値

コールバックが最後のパラメーターとして渡された場合、void を返します。それ以外の場合は Promise を返します。 結果の MSIVmTokenCredentials オブジェクトを使用してコールバックが呼び出されます。

loginWithVmMSI(MSIVmOptions)

function loginWithVmMSI(options: MSIVmOptions): Promise<MSIVmTokenCredentials>

パラメーター

options
MSIVmOptions

戻り値

loginWithVmMSI(MSIVmOptions, Callback<MSIVmTokenCredentials>)

function loginWithVmMSI(options: MSIVmOptions, callback: Callback<MSIVmTokenCredentials>)

パラメーター

options
MSIVmOptions
callback

Callback<MSIVmTokenCredentials>

loginWithVmMSI(Callback<MSIVmTokenCredentials>)

function loginWithVmMSI(callback: Callback<MSIVmTokenCredentials>)

パラメーター

callback

Callback<MSIVmTokenCredentials>

Variable Details

AuthConstants

AuthConstants: { AAD_COMMON_TENANT: string, AZURE_AUTH_LOCATION: string, DEFAULT_ADAL_CLIENT_ID: string, DEFAULT_LANGUAGE: string, RESOURCE_MANAGER_ENDPOINT: string, SDK_INTERNAL_ERROR: string }

{ AAD_COMMON_TENANT: string, AZURE_AUTH_LOCATION: string, DEFAULT_ADAL_CLIENT_ID: string, DEFAULT_LANGUAGE: string, RESOURCE_MANAGER_ENDPOINT: string, SDK_INTERNAL_ERROR: string }