Azure SQL を使用した Microsoft Entra 専用認証

Azure CLI バージョン 2.14.2 以上が必要です。

name は、サーバー名またはインスタンス名のプレフィックス (myserver など) に対応し、resource-group は、サーバーが属するリソース (myresource など) に対応します。

Azure SQL データベース

詳細については、「az sql server ad-only-auth」を参照してください。

SQL Database で有効または無効にする

[有効化]

az sql server ad-only-auth enable --resource-group myresource --name myserver

Disable

az sql server ad-only-auth disable --resource-group myresource --name myserver

SQL Database で状態を確認する

az sql server ad-only-auth get --resource-group myresource --name myserver

Azure SQL Managed Instance

詳細については、「az sql mi ad-only-auth」を参照してください。

[有効化]

az sql mi ad-only-auth enable --resource-group myresource --name myserver

Disable

az sql mi ad-only-auth disable --resource-group myresource --name myserver

SQL Managed Instance で状態を確認する

az sql mi ad-only-auth get --resource-group myresource --name myserver

Az.Sql 2.10.0 モジュール以上が必要です。

ServerName または InstanceName は、サーバー名のプレフィックス (myserver や myinstance など) に対応し、ResourceGroupName は、サーバーが属するリソース (myresource など) に対応します。

Azure SQL データベース

SQL Database で有効または無効にする

有効化

詳細については、「Enable-AzSqlServerActiveDirectoryOnlyAuthentication」を参照してください。 get-help Enable-AzSqlServerActiveDirectoryOnlyAuthentication -full を実行することもできます。

Enable-AzSqlServerActiveDirectoryOnlyAuthentication -ServerName myserver -ResourceGroupName myresource

次のコマンドを使用することもできます。

Get-AzSqlServer -ServerName myserver | Enable-AzSqlServerActiveDirectoryOnlyAuthentication

無効化

詳細については、「Disable-AzSqlServerActiveDirectoryOnlyAuthentication」を参照してください。

Disable-AzSqlServerActiveDirectoryOnlyAuthentication -ServerName myserver -ResourceGroupName myresource

SQL Database で状態を確認する

Get-AzSqlServerActiveDirectoryOnlyAuthentication  -ServerName myserver -ResourceGroupName myresource

次のコマンドを使用することもできます。

Get-AzSqlServer -ServerName myserver | Get-AzSqlServerActiveDirectoryOnlyAuthentication

Azure SQL Managed Instance

SQL Managed Instance で有効または無効にする

有効化

詳細については、「Enable-AzSqlInstanceActiveDirectoryOnlyAuthentication」を参照してください。

Enable-AzSqlInstanceActiveDirectoryOnlyAuthentication -InstanceName myinstance -ResourceGroupName myresource

次のコマンドを使用することもできます。

Get-AzSqlInstance -InstanceName myinstance | Enable-AzSqlInstanceActiveDirectoryOnlyAuthentication

これらの PowerShell コマンドの詳細については、get-help Enable-AzSqlInstanceActiveDirectoryOnlyAuthentication -full を実行してください。

無効化

詳細については、「Disable-AzSqlInstanceActiveDirectoryOnlyAuthentication」を参照してください。

Disable-AzSqlInstanceActiveDirectoryOnlyAuthentication -InstanceName myinstance -ResourceGroupName myresource

SQL Managed Instance で状態を確認する

Get-AzSqlInstanceActiveDirectoryOnlyAuthentication -InstanceName myinstance -ResourceGroupName myresource

次のコマンドを使用することもできます。

Get-AzSqlInstance -InstanceName myinstance | Get-AzSqlInstanceActiveDirectoryOnlyAuthentication

次のパラメーターを定義する必要があります。

• <subscriptionId> は、Azure portal の [サブスクリプション] に移動すると確認できます。
• <myserver> は、サーバー名またはインスタンス名のプレフィックス (myserver など) に対応します。
• <myresource> は、サーバーが属するリソース (myresource など) に対応します。

最新の MSAL を使用するには、 https://www.powershellgallery.com/packages/MSAL.PS からダウンロードします。

$subscriptionId = '<subscriptionId>'
$serverName = "<myserver>"
$resourceGroupName = "<myresource>"

Azure SQL データベース

詳細については、REST API ドキュメント「Server の Azure AD 専用認証」を参照してください。

SQL Database で有効または無効にする

[有効化]

$body = @{ properties = @{ azureADOnlyAuthentication = 1 } } | ConvertTo-Json
Invoke-RestMethod -Uri "https://management.azure.com/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.Sql/servers/$serverName/azureADOnlyAuthentications/default?api-version=2020-02-02-preview" -Method PUT -Headers $authHeader -Body $body -ContentType "application/json"

Disable

$body = @{ properties = @{ azureADOnlyAuthentication = 0 } } | ConvertTo-Json
Invoke-RestMethod -Uri "https://management.azure.com/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.Sql/servers/$serverName/azureADOnlyAuthentications/default?api-version=2020-02-02-preview" -Method PUT -Headers $authHeader -Body $body -ContentType "application/json"

SQL Database で状態を確認する

Invoke-RestMethod -Uri "https://management.azure.com/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.Sql/servers/$serverName/azureADOnlyAuthentications/default?api-version=2020-02-02-preview" -Method GET -Headers $authHeader  | Format-List

Azure SQL Managed Instance

詳細については、REST API のドキュメント「Azure SQL Managed Instance の Azure AD 専用の認証」を参照してください。

SQL Managed Instance で有効または無効にする

[有効化]

$body = @{   properties = @{  azureADOnlyAuthentication = 1 }  } | ConvertTo-Json 
Invoke-RestMethod -Uri "https://management.azure.com/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.Sql/managedInstances/$serverName/azureADOnlyAuthentications/default?api-version=2020-02-02-preview" -Method PUT -Headers $authHeader -Body $body -ContentType "application/json"

Disable

$body = @{   properties = @{  azureADOnlyAuthentication = 0 }  } | ConvertTo-Json 
Invoke-RestMethod -Uri "https://management.azure.com/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.Sql/managedInstances/$serverName/azureADOnlyAuthentications/default?api-version=2020-02-02-preview" -Method PUT -Headers $authHeader -Body $body -ContentType "application/json"

SQL Managed Instance で状態を確認する

Invoke-RestMethod -Uri "https://management.azure.com/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.Sql/managedInstances/$serverName/azureADOnlyAuthentications/default?api-version=2020-02-02-preview" -Method GET -Headers $authHeader  | Format-List

• デプロイ用に Microsoft Entra 管理者を入力します。 ユーザー オブジェクト ID は、Azure portal に移動し、[Microsoft Entra ID] リソースに移動すると確認できます。 [管理] にある [ユーザー] を選択します。 Azure SQL Server の Microsoft Entra 管理者として設定するユーザーを検索します。 ユーザーを選択すると、その [プロファイル] ページにオブジェクト ID が表示されます。
• テナント ID は、Microsoft Entra ID リソースの [概要] ページで確認できます。

Azure SQL データベース

有効化

次の ARM テンプレートは、Azure SQL データベースで Microsoft Entra 専用の認証を有効にします。 Microsoft Entra 専用認証を無効にするには、azureADOnlyAuthentication プロパティを false に設定します。

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
    "contentVersion": "1.0.0.1",
    "parameters": {
        "sqlServer_name": {
            "type": "String"
        },
        "aad_admin_name": {
            "type": "String"
        },
        "aad_admin_objectid": {
            "type": "String"
        },
        "aad_admin_tenantid": {
            "type": "String"
        }
    },
    "resources": [
        {
            "type": "Microsoft.Sql/servers/administrators",
            "apiVersion": "2020-02-02-preview",
            "name": "[concat(parameters('sqlServer_name'), '/ActiveDirectory')]",
            "properties": {
                "administratorType": "ActiveDirectory",
                "login": "[parameters('aad_admin_name')]",
                "sid": "[parameters('aad_admin_objectid')]",
                "tenantId": "[parameters('aad_admin_tenantId')]"
            }
        },        
        {
            "type": "Microsoft.Sql/servers/azureADOnlyAuthentications",
            "apiVersion": "2020-02-02-preview",
            "name": "[concat(parameters('sqlServer_name'), '/Default')]",
            "dependsOn": [
                "[resourceId('Microsoft.Sql/servers/administrators', parameters('sqlServer_name'), 'ActiveDirectory')]"
            ],
            "properties": {
                "azureADOnlyAuthentication": true
            }
        }
    ]
}

詳細については、「Microsoft.Sql servers/azureADOnlyAuthentications」を参照してください。

Azure SQL Managed Instance

有効化

次の ARM テンプレートは、Azure SQL Managed Instance で Microsoft Entra 専用の認証を有効にします。 Microsoft Entra 専用認証を無効にするには、azureADOnlyAuthentication プロパティを false に設定します。

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
    "contentVersion": "1.0.0.1",
    "parameters": {
        "instance": {
            "type": "String"
        },
        "aad_admin_name": {
            "type": "String"
        },
        "aad_admin_objectid": {
            "type": "String"
        },
        "aad_admin_tenantid": {
            "type": "String"
        }
    },
    "resources": [
        {
            "type": "Microsoft.Sql/managedInstances/administrators",
            "apiVersion": "2020-02-02-preview",
            "name": "[concat(parameters('instance'), '/ActiveDirectory')]",
            "properties": {
                "administratorType": "ActiveDirectory",
                "login": "[parameters('aad_admin_name')]",
                "sid": "[parameters('aad_admin_objectid')]",
                "tenantId": "[parameters('aad_admin_tenantId')]"
            }
        },
        {
            "type": "Microsoft.Sql/managedInstances/azureADOnlyAuthentications",
            "apiVersion": "2020-02-02-preview",
            "name": "[concat(parameters('instance'), '/Default')]",
            "dependsOn": [
                "[resourceId('Microsoft.Sql/managedInstances/administrators', parameters('instance'), 'ActiveDirectory')]"
            ],
            "properties": {
                "azureADOnlyAuthentication": true
            }
        }
    ]
}

詳細については、「Microsoft.Sql managedInstances/azureADOnlyAuthentications」を参照してください。