Azure Automation で資格情報を管理する

Automation 資格情報資産は、ユーザー名とパスワードなどのセキュリティ資格情報を含むオブジェクトを保持しています。 Runbook と DSC 構成では、認証のための PSCredential オブジェクトを受け入れるコマンドレットを使用します。 または、PSCredential オブジェクトのユーザー名とパスワードを抽出して、認証を必要とする一部のアプリケーションまたはサービスに提供することもできます。

資格情報へのアクセスに使用する PowerShell コマンドレット

PowerShell を使用して Automation 資格情報を作成および管理するためのコマンドレットを次の表に示します。 これらは、Az モジュールに付属しています。

資格情報へのアクセスに使用するその他のコマンドレット

次の表のコマンドレットは、Runbook および DSC 構成で資格情報にアクセスするために使用されます。

コード内の PSCredential オブジェクトを取得するには、Orchestrator.AssetManagement.Cmdlets モジュールをインポートする必要があります。 詳細については、「Azure Automation でモジュールを管理する」をご覧ください。

Import-Module Orchestrator.AssetManagement.Cmdlets -ErrorAction SilentlyContinue

資格情報にアクセスする Python 関数

次の表の関数を使用して、Python 2 および 3 の Runbook の資格情報にアクセスします。 Python 3 Runbook は現在プレビュー段階です。

新しい資格情報資産を作成する

Azure portal または Windows PowerShell を使用して、新しい資格情報資産を作成できます。

Azure portal での新しい資格情報資産の作成

1. [Automation アカウント] から、左側のペインで、[共有リソース] の [資格情報] を選択します。

2. [資格情報] ページで、[資格情報の追加] を選択します。

3. [新しい資格情報] ウィンドウで、命名規則に従って、適切な資格情報名を入力します。

4. [ユーザー名] フィールドにアクセス ID を入力します。

5. 両方のパスワード フィールドに、シークレット アクセス キーを入力します。

   

6. [多要素認証] チェックボックスがオンになっている場合は、オフにします。

7. [作成] をクリックして、新しい資格情報資産を保存します。

Windows PowerShell で新しい資格情報資産を作成する

次の例では、新しい Automation 資格情報資産を作成する方法について説明します。 最初に名前とパスワードで PSCredential オブジェクトを作成し、それを使用して資格情報資産を作成します。 または、Get-Credential コマンドレットを使用して、ユーザーに名前とパスワードの入力を求めることもできます。

$user = "MyDomain\MyUser"
$pw = ConvertTo-SecureString "PassWord!" -AsPlainText -Force
$cred = New-Object –TypeName System.Management.Automation.PSCredential –ArgumentList $user, $pw
New-AzureAutomationCredential -AutomationAccountName "MyAutomationAccount" -Name "MyCredential" -Value $cred

資格情報資産を取得する

Runbook または DSC 構成では、内部の Get-AutomationPSCredential コマンドレットを使用して、資格情報資産を取得します。 このコマンドレットは、資格情報を必要とするコマンドレットで使用できる PSCredential オブジェクトを取得します。 また、資格情報オブジェクトのプロパティを取得して個別に使用することもできます。 このオブジェクトには、ユーザー名とセキュリティで保護されたパスワードのプロパティがあります。

または、GetNetworkCredential メソッドを使用して、安全ではないバージョンのパスワードを表す NetworkCredential オブジェクトを取得することもできます。

テキスト形式の Runbook の例

$myCredential = Get-AutomationPSCredential -Name 'MyCredential'
$userName = $myCredential.UserName
$securePassword = $myCredential.Password
$password = $myCredential.GetNetworkCredential().Password

# Ensures you do not inherit an AzContext in your runbook
Disable-AzContextAutosave -Scope Process

# Connect to Azure with system-assigned managed identity
$AzureContext = (Connect-AzAccount -Identity).context

# set and store context
$AzureContext = Set-AzContext -SubscriptionName $AzureContext.Subscription -DefaultProfile $AzureContext

# Get credential
$myCred = Get-AutomationPSCredential -Name "MyCredential"
$userName = $myCred.UserName
$securePassword = $myCred.Password
$password = $myCred.GetNetworkCredential().Password

$myPsCred = New-Object System.Management.Automation.PSCredential ($userName,$securePassword)

# Connect to Azure with credential
$AzureContext = (Connect-AzAccount -Credential $myPsCred -TenantId $AzureContext.Subscription.TenantId).context

# set and store context
$AzureContext = Set-AzContext -SubscriptionName $AzureContext.Subscription `
    -TenantId $AzureContext.Subscription.TenantId `
    -DefaultProfile $AzureContext

import automationassets
from automationassets import AutomationAssetNotFound

# get a credential
cred = automationassets.get_automation_credential("credtest")
print cred["username"]
print cred["password"]

import automationassets
from automationassets import AutomationAssetNotFound

# get a credential
cred = automationassets.get_automation_credential("credtest")
print (cred["username"])
print (cred["password"])

グラフィカルな Runbook の例

グラフィカル エディターの [ライブラリ] ペインで資格情報を右クリックし、[キャンバスに追加] を選択することで、内部 Get-AutomationPSCredential コマンドレットのアクティビティをグラフィカルな Runbook に追加できます。

次の図は、グラフィカルな Runbook で資格情報を使用する例を示したものです。 この例では、「Azure Automation で Microsoft Entra ID を使用して Azure に対して認証する」で説明されているように、資格情報によって、Azure リソースに対する認証が Runbook に提供されています。 最初のアクティビティは、Azure サブスクリプションへのアクセス権を持つ資格情報を取得します。 その後、アカウント接続アクティビティは、この資格情報を使用して、その後にあるすべてのアクティビティに認証を提供します。 ここでは、Get-AutomationPSCredential が単一オブジェクトを想定しているため、パイプライン リンクが使用されています。

DSC 構成で資格情報を使用する

Azure Automation の DSC 構成では、Get-AutomationPSCredential を使用して資格情報資産を操作できますが、パラメーターを使用して資格情報資産を渡すこともできます。 詳細については、「 Azure Automation DSC での構成のコンパイル」を参照してください。

次のステップ

• 証明書へのアクセスに使用するコマンドレットの詳細については、「Azure Automation でモジュールを管理する」を参照してください。
• Runbook の一般的な情報については、「Azure Automation での Runbook の実行」を参照してください。
• DSC 構成の詳細については、「Azure Automation State Configuration の概要」を参照してください。