Java アプリケーションを移行して、Azure SQL Database とのパスワードなしの接続を使用する

1. プロジェクト内で、次の参照をパッケージに azure-identity 追加します。 このライブラリには、パスワードレス接続を実装するために必要なすべてのエンティティが含まれています。

   <dependency>
        <groupId>com.azure</groupId>
        <artifactId>azure-identity</artifactId>
        <version>1.5.4</version>
   </dependency>
   

2. JDBC URL.v で Microsoft Entra マネージド ID 認証を有効にします。Azure SQL Database に接続するための場所を現在作成 java.sql.Connection しているコード内の場所を識別します。 次の例に合わせてコードを更新します。

   String url = "jdbc:sqlserver://$AZ_DATABASE_SERVER_NAME.database.windows.net:1433;databaseName=$AZ_DATABASE_NAME;authentication=ActiveDirectoryMSI;"   
   Connection con = DriverManager.getConnection(url);
   

3. 2 つの $AZ_DATABASE_SERVER_NAME 変数と 1 つの $AZ_DATABASE_NAME 変数を、この記事の冒頭で構成した値に置き換えます。

4. JDBC URL を user 削除します password 。

1. プロジェクト内で、パッケージへの参照を spring-cloud-azure-starter 追加します。 このライブラリには、パスワードレス接続を実装するために必要なすべてのエンティティが含まれています。

   <dependency>
       <groupId>com.azure.spring</groupId>
       <artifactId>spring-cloud-azure-starter</artifactId>
   </dependency>
   

   Note

   部品表 (BOM) を使用して Spring Cloud Azure ライブラリのバージョンを管理する方法の詳細については、 「Spring Cloud Azure 開発者ガイド」 の 「概要」 セクションを参照してください。

2. 次の例に示すように、 application.yaml または application.properties ファイルを更新します。 削除 spring.datasource.username と spring.datasource.password プロパティ。

   spring:
     datasource:
       url: jdbc:sqlserver://${AZ_DATABASE_SERVER_NAME}.database.windows.net:1433;databaseName=${AZ_DATABASE_NAME};authentication=ActiveDirectoryMSI;
   

1. Azure アプリ サービス インスタンスのメイン概要ページで、ナビゲーション ウィンドウから [ID] を選択します。

2. [システム割り当て済み] タブで、[ステータス] フィールドをオンに設定します。 システム割り当て ID は Azure によって内部的に管理され、この ID によって管理タスクが自動的に処理されます。 ID の詳細と ID がコードで公開されることはありません。

Service Connector を使用すると、Azure ホスティング環境にシステム割り当てマネージド ID を割り当てるのに役立ちます。 ただし、Azure portal ではこの方法での Azure Database の構成はサポートされていないため、Azure CLI を使用して ID を割り当てる必要があります。

1. Azure Container App インスタンスのメイン概要ページで、ナビゲーション ウィンドウから [ID] を選択します。

2. [システム割り当て済み] タブで、[ステータス] フィールドをオンに設定します。 システム割り当て ID は Azure によって内部的に管理され、この ID によって管理タスクが自動的に処理されます。 ID の詳細と ID がコードで公開されることはありません。

   

1. Azure Spring Apps インスタンスのメイン概要ページで、ナビゲーション ウィンドウから [ID] を選択します。

2. [システム割り当て済み] タブで、[ステータス] フィールドをオンに設定します。 システム割り当て ID は Azure によって内部的に管理され、この ID によって管理タスクが自動的に処理されます。 ID の詳細と ID がコードで公開されることはありません。

   

1. 仮想マシンのメインの概要ページで、ナビゲーション ウィンドウから [ID] を選択します。

2. [システム割り当て済み] タブで、[ステータス] フィールドをオンに設定します。 システム割り当て ID は Azure によって内部的に管理され、この ID によって管理タスクが自動的に処理されます。 ID の詳細と ID がコードで公開されることはありません。

   

Azure Kubernetes Service (AKS) クラスターでは、ロード バランサーやマネージド ディスクなどの Azure リソースにアクセスするための ID が必要です。 この ID には、マネージド ID またはサービス プリンシパルを指定できます。 既定では、AKS クラスターを作成すると、システム割り当てマネージド ID が自動的に作成されます。

次の例に示すように、az webapp identity assign コマンドを使用して、マネージド ID を Azure アプリ Service インスタンスに割り当てることができます。

export AZ_MI_OBJECT_ID=$(az webapp identity assign \
    --resource-group $AZ_RESOURCE_GROUP \
    --name <service-instance-name> \
    --query principalId \
    --output tsv)

Service Connector を使用すると、Azure CLI を使用して、Azure コンピューティング ホスティング環境とターゲット サービスの間に接続を作成できます。 Service Connector では現在、次のコンピューティング サービスがサポートされています。

• Azure App Service
• Azure Spring Apps
• Azure Container Apps

まず、Azure CLI 用 Service Connector パスワードレス拡張機能をインストールします。

az extension add --name serviceconnector-passwordless --upgrade

Azure アプリ Service を使用している場合は、次のaz webapp connection例に示すようにコマンドを使用します。

az webapp connection create sql \
    --resource-group $AZ_RESOURCE_GROUP \
    --name <app-service-name>
    --target-resource-group $AZ_RESOURCE_GROUP \
    --server $AZ_DATABASE_SERVER_NAME \
    --database $AZ_DATABASE_NAME \
    --system-identity

Azure Spring Apps を使用している場合は、次の例に示すようにコマンドを使用 the az spring connection します。

az spring connection create sql \
    --resource-group $AZ_RESOURCE_GROUP \
    --service <service-name> \
    --app <service-instance-name> \
    --target-resource-group $AZ_RESOURCE_GROUP \
    --server $AZ_DATABASE_SERVER_NAME \
    --database $AZ_DATABASE_NAME \
    --system-identity

Azure Container Apps を使用している場合は、次の az containerapp connection 例に示すように、コマンドを使用します。

az containerapp connection create sql \
    --resource-group $AZ_RESOURCE_GROUP \
    --name <app-service-name>
    --target-resource-group $AZ_RESOURCE_GROUP \
    --server $AZ_DATABASE_SERVER_NAME \
    --database $AZ_DATABASE_NAME \
    --system-identity

次の例に示すように、az containerapp identity assign コマンドを 使用して、マネージド ID を Azure Container Apps インスタンスに割り当 てることができます。

export AZ_MI_OBJECT_ID=$(az containerapp identity assign \
    --resource-group $AZ_RESOURCE_GROUP \
    --name <service-instance-name> \
    --query principalId \
    --output tsv)

次の例に示すように、az spring app identity assign コマンドを 使用して、マネージド ID を Azure Spring Apps インスタンスに割り当 てることができます。

export AZ_MI_OBJECT_ID=$(az spring app identity assign \
    --resource-group $AZ_RESOURCE_GROUP \
    --name <service-instance-name> \
    --service <service-name> \
    --query identity.principalId \
    --output tsv)

次の例に示すように、az vm identity assign コマンドを 使用して、マネージド ID を仮想マシンに割り当 てることができます。

export AZ_MI_OBJECT_ID=$(az vm identity assign \
    --resource-group $AZ_RESOURCE_GROUP \
    --name <service-instance-name> \
    --query principalId \
    --output tsv)

次の例に示すように、az aks update コマンドを使用して、マネージド ID を Azure Kubernetes Service (AKS) インスタンスに割り当てることができます。

export AZ_MI_OBJECT_ID=$(az aks update \
    --resource-group $AZ_RESOURCE_GROUP \
    --name <AKS-cluster-name> \
    --enable-managed-identity \
    --query identityProfile.kubeletidentity.objectId \
    --output tsv)

Service Connector を使用してサービスを接続した場合は、前の手順のコマンドでロールが既に割り当てられているため、この手順は省略できます。

この手順では、マネージド ID のデータベース ユーザーを作成し、それに対する読み取りと書き込みのアクセス許可を付与します。

次のコマンドは、マネージド ID の表示名を取得し、マネージド ID のユーザーを作成し、アクセス許可を付与するコマンドを作成します。

export AZ_DATABASE_AD_MI_USERNAME=$(az ad sp show \
    --id $AZ_MI_OBJECT_ID \
    --query displayName \
    --output tsv)
cat << EOF
CREATE USER "$AZ_DATABASE_AD_MI_USERNAME" FROM EXTERNAL PROVIDER;
ALTER ROLE db_datareader ADD MEMBER "$AZ_DATABASE_AD_MI_USERNAME";
ALTER ROLE db_datawriter ADD MEMBER "$AZ_DATABASE_AD_MI_USERNAME";
GO
EOF

このコマンドの出力をコピーし、Azure portal に移動して SQL データベースを見つけます。 次のスクリーンショットに示すように、Microsoft Entra 管理者ユーザーとしてクエリ エディターにサインインします。

次のスクリーンショットに示すように、最後のコマンドの出力をクエリ エディターに貼り付け、SQL コマンドを実行します。