ライフサイクルワークフローで使用するためにロジックアプリを構成する

[アーティクル]
02/07/2024

既存の Azure ロジックアプリをライフサイクルワークフローのカスタムタスク拡張機能で使う前に、まず互換性を持たせる必要があります。このリファレンスガイドでは、Azure ロジックアプリに互換性を持たせるために必要な手順の一覧を示します。ライフサイクルワークフローポータルを使って新しい互換性のあるロジックアプリを作成するためのガイドについては、「カスタムタスク拡張機能に基づいて Logic Apps をトリガーする」を参照してください。

カスタムタスク拡張機能のトークンセキュリティの種類を決定する

ライフサイクルワークフローで使用する Azure ロジックアプリカスタム拡張機能を構成する前に、まず、そのトークンセキュリティの種類を把握する必要があります。 2 つのトークンセキュリティの種類は、次のいずれかになります。

標準
所有証明 (PoP)

カスタムタスク拡張機能のセキュリティトークンの種類を確認するには、[カスタム拡張機能] ページをチェックします。

カスタムタスク拡張機能とトークンの種類のスクリーンショット。

注意

新しいカスタムタスク拡張機能には、所有証明 (POP) トークンのセキュリティの種類のみが含まれます。所有証明トークンのセキュリティの種類を含める前に作成されたタスク拡張機能のみが、標準の種類になります。

LCW を使用するために既存のロジックアプリを構成する

Azure ロジックアプリをカスタムタスク拡張機能で実行できるように互換性を持たせるには、次の手順が必要です。

ロジックアプリのトリガーを構成する
コールバックアクションを構成する (コールバックシナリオにのみ適用されます)。
システム割り当てマネージド ID を有効にします (通常のセキュリティトークンの種類の拡張機能には常に必要です。これは、カスタムタスク拡張機能を使用するコールバックシナリオの既定値でもあります。この詳細、および他のカスタムタスク拡張機能の展開シナリオについては、「カスタムタスク拡張機能のデプロイシナリオ」を参照してください。
AuthZ ポリシーを構成します。

これらを構成するには、次の手順を実行します。

ライフサイクルワークフローで使う Azure ロジックアプリを開きます。ロジックアプリの紹介画面が表示されることがありますが、右上隅の [X] を選んで閉じることができます。
画面の左側にある [ロジックアプリコードビュー] を選びます。

エディターに次のコードを貼り付けます。

{
  "definition": {
    "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#",
    "actions": {
      "HTTP": {
        "inputs": {
          "authentication": {
            "audience": "https://graph.microsoft.com",
            "type": "ManagedServiceIdentity"
          },
          "body": {
            "data": {
              "operationStatus": "Completed"
            },
            "source": "sample",
            "type": "lifecycleEvent"
          },
          "method": "POST",
          "uri": "https://graph.microsoft.com/beta@{triggerBody()?['data']?['callbackUriPath']}"
        },
        "runAfter": {},
        "type": "Http"
      }
    },
    "contentVersion": "1.0.0.0",
    "outputs": {},
    "parameters": {},
    "triggers": {
      "manual": {
        "inputs": {
          "schema": {
            "properties": {
              "data": {
                "properties": {
                  "callbackUriPath": {
                    "description": "CallbackUriPath used for Resume Action",
                    "title": "Data.CallbackUriPath",
                    "type": "string"
                  },
                  "subject": {
                    "properties": {
                      "displayName": {
                        "description": "DisplayName of the Subject",
                        "title": "Subject.DisplayName",
                        "type": "string"
                      },
                      "email": {
                        "description": "Email of the Subject",
                        "title": "Subject.Email",
                        "type": "string"
                      },
                      "id": {
                        "description": "Id of the Subject",
                        "title": "Subject.Id",
                        "type": "string"
                      },
                      "manager": {
                        "properties": {
                          "displayName": {
                            "description": "DisplayName parameter for Manager",
                            "title": "Manager.DisplayName",
                            "type": "string"
                          },
                          "email": {
                            "description": "Mail parameter for Manager",
                            "title": "Manager.Mail",
                            "type": "string"
                          },
                          "id": {
                            "description": "Id parameter for Manager",
                            "title": "Manager.Id",
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "userPrincipalName": {
                        "description": "UserPrincipalName of the Subject",
                        "title": "Subject.UserPrincipalName",
                        "type": "string"
                      }
                    },
                    "type": "object"
                  },
                  "task": {
                    "properties": {
                      "displayName": {
                        "description": "DisplayName for Task Object",
                        "title": "Task.DisplayName",
                        "type": "string"
                      },
                      "id": {
                        "description": "Id for Task Object",
                        "title": "Task.Id",
                        "type": "string"
                      }
                    },
                    "type": "object"
                  },
                  "taskProcessingResult": {
                    "properties": {
                      "createdDateTime": {
                        "description": "CreatedDateTime for TaskProcessingResult Object",
                        "title": "TaskProcessingResult.CreatedDateTime",
                        "type": "string"
                      },
                      "id": {
                        "description": "Id for TaskProcessingResult Object",
                        "title": "TaskProcessingResult.Id",
                        "type": "string"
                      }
                    },
                    "type": "object"
                  },
                  "workflow": {
                    "properties": {
                      "displayName": {
                        "description": "DisplayName for Workflow Object",
                        "title": "Workflow.DisplayName",
                        "type": "string"
                      },
                      "id": {
                        "description": "Id for Workflow Object",
                        "title": "Workflow.Id",
                        "type": "string"
                      },
                      "workflowVersion": {
                        "description": "WorkflowVersion for Workflow Object",
                        "title": "Workflow.WorkflowVersion",
                        "type": "integer"
                      }
                    },
                    "type": "object"
                  }
                },
                "type": "object"
              },
              "source": {
                "description": "Context in which an event happened",
                "title": "Request.Source",
                "type": "string"
              },
              "type": {
                "description": "Value describing the type of event related to the originating occurrence.",
                "title": "Request.Type",
                "type": "string"
              }
            },
            "type": "object"
          }
        },
        "kind": "Http",
        "type": "Request"
      }
    }
  },
  "parameters": {}
}

[保存] を選択します。
[ロジックアプリデザイナー] に切り替え、構成したトリガーとコールバックアクションを確認します。カスタムビジネスロジックを構築するには、トリガーとコールバックアクションの間に他のアクションを追加します。ファイアアンドフォーゲットシナリオのみに関心がある場合は、このコールバックアクションを削除できます。
画面の左側にある [ID] を選びます。
[システム割り当て済み] タブで、Microsoft Entra ID に登録する状態を有効にします。
[保存] を選択します。

POP セキュリティトークンの種類を使用してカスタムタスク拡張機能の認可ポリシーを構成する

カスタムタスク拡張機能のセキュリティトークンの種類が所有証明 (POP) の場合は、次の手順に従って認可ポリシーを設定します。

作成したロジックアプリに移動し、[認可] を選びます。

次の表に基づいて、認可ポリシーを作成します。

ポリシー名: POP-Policy

ポリシーの種類: AADPOP

要求	値
発行者	https://sts.windows.net/(Tenant ID)/
appid	00001111-aaaa-2222-bbbb-3333cccc4444
m	POST
u	management.azure.com
p	/subscriptions/(subscriptionId)/resourceGroups/(resourceGroupName)/providers/Microsoft.Logic/workflows/(LogicApp name)

承認ポリシーを保存します。

注意事項

些細な違いが後々問題になる可能性があるため、細心の注意を払ってください。

Issuer のテナント ID の後に、スラッシュが含まれていることを確認します。
appid のカスタム要求が、すべて小文字の appid になっていることを確認します。 appid の値はライフサイクルワークフローを表し、常に同じです。

通常のセキュリティトークンの種類を使用してカスタムタスク拡張機能の認可ポリシーを構成する

カスタムタスク拡張機能のセキュリティトークンの種類が通常の場合は、次の手順に従って認可ポリシーを設定します。

Logic Apps の認可ポリシーには、マネージド ID のアプリケーション ID が必要です。 Microsoft Entra 管理センターには [オブジェクト ID] しか表示されないので、アプリケーション ID を調べる必要があります。 Microsoft Entra の管理センターの [エンタープライズアプリケーション] で、オブジェクト ID でマネージド ID を検索することで、必要なアプリケーション ID を見つけることができます。
作成したロジックアプリに戻り、[承認] を選びます。

次の表に基づいて、2 つの認可ポリシーを作成します。

ポリシー名: AzureADLifecycleWorkflowsAuthPolicy

ポリシーの種類: AAD

要求	値
発行者	https://sts.windows.net/(Tenant ID)/
対象ユーザー	ロジックアプリのマネージド ID のアプリケーション ID
appid	00001111-aaaa-2222-bbbb-3333cccc4444

ポリシー名: AzureADLifecycleWorkflowsAuthPolicyV2App

ポリシーの種類: AAD

要求	値
発行者	https://login.microsoftonline.com/(Tenant ID)/v2.0
対象ユーザー	ロジックアプリのマネージド ID のアプリケーション ID
azp	ce79fdc4-cd1d-4ea5-8139-e74d7dbe0bb7

承認ポリシーを保存します。

注意事項

些細な違いが後々問題になる可能性があるため、細心の注意を払ってください。

Issuer のテナント ID の後に、スラッシュが含まれていることを確認します。
対象ユーザーのマネージド ID には、オブジェクト ID ではなく、アプリケーション ID を使っていることを確認します。
appid のカスタム要求が、すべて小文字の appid になっていることを確認します。 appid の値はライフサイクルワークフローを表し、常に同じです。

ライフサイクルワークフローでのロジックアプリの使用

ライフサイクルワークフローで使用するようにロジックアプリが構成されたので、UI または API を使用してカスタムタスク拡張機能を作成し、ライフサイクルワークフローで使用することができます。

次の方法で共有

ライフサイクルワークフローで使用するためにロジックアプリを構成する

カスタムタスク拡張機能のトークンセキュリティの種類を決定する

LCW を使用するために既存のロジックアプリを構成する

POP セキュリティトークンの種類を使用してカスタムタスク拡張機能の認可ポリシーを構成する

通常のセキュリティトークンの種類を使用してカスタムタスク拡張機能の認可ポリシーを構成する

ライフサイクルワークフローでのロジックアプリの使用

次のステップ

フィードバック

フィードバック

その他のリソース

次の方法で共有

ライフサイクル ワークフローで使用するためにロジック アプリを構成する

カスタム タスク拡張機能のトークン セキュリティの種類を決定する

LCW を使用するために既存のロジック アプリを構成する

POP セキュリティ トークンの種類を使用してカスタム タスク拡張機能の認可ポリシーを構成する

通常のセキュリティ トークンの種類を使用してカスタム タスク拡張機能の認可ポリシーを構成する

ライフサイクル ワークフローでのロジック アプリの使用

次のステップ

フィードバック

フィードバック

その他のリソース

ライフサイクルワークフローで使用するためにロジックアプリを構成する

カスタムタスク拡張機能のトークンセキュリティの種類を決定する

LCW を使用するために既存のロジックアプリを構成する

POP セキュリティトークンの種類を使用してカスタムタスク拡張機能の認可ポリシーを構成する

通常のセキュリティトークンの種類を使用してカスタムタスク拡張機能の認可ポリシーを構成する

ライフサイクルワークフローでのロジックアプリの使用