AEM Forms as a Cloud Service と Adobe Acrobat Sign の接続 integrate-adobe-sign-with-aem-forms
Adobe Acrobat Sign により、アダプティブフォームや AEM ワークフローの電子サインワークフローを有効にできます。電子サインを使用すると、法務、販売、給与、人事管理など、様々な分野におけるドキュメント処理ワークフローが改善されます。
Adobe Acrobat Sign とアダプティブフォームの一般的なシナリオでは、ユーザーがアダプティブフォームに入力してサービスを申し込みます。例えば、クレジットカードの申込フォームや住民サービスフォームなどです。ユーザーが申込フォームの入力、送信、署名を行うと、追加のアクションのためにサービスプロバイダーにそのフォームが送信されます。サービスプロバイダーは受信した申込フォームを確認し、Adobe Acrobat Sign を使用して申請を承認します。AEM Forms は、Adobe Acrobat Sign および Adobe Acrobat Sign Solutions for Government の両方をサポートしています。ライセンスと要件に応じて、次のいずれかのソリューションと AEM Forms を統合または接続できます。
AEM Forms と Adobe Acrobat Sign の接続 adobe-sign
AEM Forms と Adobe Acrobat Sign を接続するには、前提条件セクションに示すソフトウェアとアカウントを設定して、Forms as a Cloud Service のオーサーインスタンスとパブリッシュインスタンスで Adobe Sign Cloud Service を設定します。
AEM Forms と Adobe Acrobat Sign を接続するための前提条件 prerequisites-for-adobe-sign
Adobe Acrobat Sign を AEM Forms に統合するには、以下の設定が必要になります。
- 有効な Adobe Acrobat Sign デベロッパーアカウント。
- Adobe Acrobat Sign API アプリケーション。
- Adobe Acrobat Sign API アプリケーションの資格情報(クライアント ID およびクライアントの秘密鍵)。
- (行政 ID に基づいた認証の場合のみ)行政 ID 認証による認証方法を有効にします。
AEM Forms のオーサーインスタンスおよびパブリッシュインスタンスと Adobe Acrobat Sign の接続 configure-adobe-sign-with-aem-forms
上記の前提条件の準備が完了したら、以下の手順により、オーサーインスタンス上の AEM Forms を使用して Adobe Acrobat Sign を設定します。
-
AEM Forms のオーサーインスタンスで、ツール /一般/設定ブラウザー に移動します。
-
設定ブラウザー ページで「作成」を設定します。
-
設定を作成 ダイアログで、設定の タイトル を指定し、「クラウド設定」を有効にして「作成」を選択します。これにより、Cloud Services 用の設定コンテナが作成されます。フォルダー名にスペースが含まれていないことを確認します。
-
ツール /Cloud Services/Adobe Acrobat Sign に移動し、上記の手順で作成した設定コンテナを開きます。
note note NOTE アダプティブフォームを作成する際に、設定コンテナ フィールドにコンテナ名を指定します。 -
設定ページで「作成」を選択して、AEM Forms 内に Adobe Acrobat Sign の設定を作成します。
-
Adobe Acrobat Sign 設定を作成 ページの「一般」タブで、設定の 名前 を指定して「次へ」を選択します。必要に応じて タイトル を指定し、設定の サムネ―ル を参照して選択することもできます。
-
これで、ソリューションを選択 して、Adobe Acrobat Sign を選択できます。
-
現在のブラウザーウィンドウに存在する URL をメモ帳にコピーし、URL から
/ui#/aem
の部分を削除します。この修正した URL は、後の手順で Adobe Acrobat Sign アプリケーションと AEM Forms を設定する際に必要です。「次へ」を選択します。 -
「設定」タブで、
-
「OAuth URL」フィールドには、Adobe Sign データベースシャードを含むデフォルトの URL が含まれます。URL の形式は次の通りです。
https://<shard>/public/oauth/v2
次に例を示します。
https://secure.na1.echosign.com/public/oauth/v2
-
トークン URL にアクセス フィールドには、Adobe Sign データベースシャードを含むデフォルトの URL が含まれます。URL の形式は次の通りです。
https://<shard>/oauth/v2/token
次に例を示します。
https://api.na1.echosign.com/oauth/v2/token
各パラメーターの意味は次のとおりです。
na1 は、デフォルトのデータベースシャードを参照します。データベースシャードの値を更新することができます。 Adobe Acrobat Sign クラウド設定で、正しいシャードをポイントしていることを確認します。
note note NOTE - Adobe Acrobat Sign 設定を作成 ページを開いたままにします。閉じないでください。 クライアント ID および クライアント秘密鍵 は、以降の手順で説明するように、Adobe Acrobat Sign アプリケーションの OAuth 設定を行った後に取得できます。
- Adobe Sign アカウントにログインした後、Acrobat Sign API/API 情報/REST API メソッドのドキュメント/OAuth アクセストークン に移動して、Adobe Sign OAuth URL およびアクセストークン URL に関連する情報にアクセスします。
-
-
以下の手順により、Adobe Acrobat Sign アプリケーション用に OAuth 設定を構成します。
-
ブラウザーウィンドウを開き、Adobe Acrobat Sign 開発者アカウントにログインします。
-
AEM Forms 用に設定されているアプリケーションを選択し、「アプリケーションの OAuth を設定」を選択します。
-
前述の手順(手順 8)でコピーした URL を「リダイレクト URL」ボックスに追加して「保存」をクリックします。
-
Adobe Acrobat Sign アプリケーションに対して以下の範囲を有効にして、「保存」をクリックします。
- aggrement_read
- aggrement_write
- aggrement_send
- widget_read
- widget_write
- workflow_read
Adobe Acrobat Sign アプリケーション用に OAuth 設定を構成してキーを取得するための詳しい手順については、開発者用ドキュメントのアプリケーション用に OAuth 設定を構成するを参照してください。
-
-
Adobe Acrobat Sign 設定を作成 ページに戻ります。「設定」タブで、「クライアント ID(アプリケーション ID)と クライアントシークレット」の値を指定します。前述の手順で作成した Adobe Acrobat Sign アプリケーションのクライアント ID とクライアントシークレットを使用します。
-
「添付ファイルの Adobe Acrobat Sign を有効にする」オプションを選択すると、アダプティブフォームに添付されているファイルが、署名用に送信された対応する Adobe Acrobat Sign ドキュメントに添付されます。
-
「Adobe Acrobat Sign に接続」を選択します。資格情報の入力画面が表示されたら、Adobe Acrobat Sign アプリケーションの作成時に使用した ユーザー名 と パスワード を入力します。
your developer account
へのアクセスを確認するメッセージが表示されたら、「アクセスを許可」をクリックします。資格情報が正しく、AEM Forms が Adobe Acrobat Sign 開発者アカウントにアクセスできるようにした場合は、次のような成功メッセージが表示されます。 -
「作成」を選択して、Adobe Acrobat Sign 設定を作成します。
-
設定を選択し、「公開」をクリックします 。 これにより、対応するパブリッシュ環境に設定が複製されます。
-
開発者、ステージ、実稼働用のインスタンス(残っているいずれか)で上記の手順をすべて繰り返し、お使いの環境用に Adobe Acrobat Sign を AEM Forms で設定する作業を完了します。
これで、アダプティブフォームに Adobe Acrobat Sign フィールドを追加する機能を使用できるようになりました。Adobe Acrobat Sign 用に有効化するすべてのアダプティブフォームに、Cloud Service に使用する設定コンテナを追加してください。設定コンテナは、アダプティブフォームのプロパティから指定できます。
トラブルシューティング resolve-config-error
Adobe Acrobat Sign を AEM Forms と接続すると、次の画像に示すように、「Unable to authorize access because the client configuration is invalid: invalid_request
」というエラーが発生します。これを解決するには、下記の手順に従います。
- 現在のブラウザーウィンドウに存在する URL をメモ帳にコピーし、URL から
/ui#/aem
の部分を削除します。 - ブラウザーウィンドウを開き、Adobe Acrobat Sign 開発者アカウントにログインします。
- AEM Forms 用に設定されているアプリケーションを選択し、「アプリケーションの OAuth を設定」を選択します。
- 上記の手順でコピーした URL を「リダイレクト URL」ボックスに追加して「保存」をクリックします。
AEM Forms と Adobe Acrobat Sign Solutions for Government を接続 adobe-acrobat-sign-for-government
AEM Forms と Adobe Acrobat Sign Solutions for Government の接続は、複数の手順で構成されます。以下が含まれます。
- AEM インスタンスのリダイレクト URL の作成
- リダイレクト URL とスコープを Adobe Sign Solutions for Government チームと共有
- Adobe Sign チームからの資格情報の受信
- 受け取った資格情報を使用して AEM Forms を Adobe Acrobat Sign Solutions for Government と接続
AEM Formsas a Cloud Service は、開発環境、ステージ環境、実稼動環境を提供します。まずは開発環境を Adobe Acrobat Sign Solutions for Government に接続し、後でステージ環境と運用環境に接続することができます。
事前準備 prerequisites-for-adobe-sign-for-acrobat-sign-for-government
AEM Forms と Adobe Acrobat Sign Solution の接続を開始する前に、Adobe Acrobat Sign Solutions for Government アカウントがプロビジョニングされていることを確認してください。
AEM Forms as a Cloud Service を Adobe Acrobat Sign Solutions for Government に接続 connect-adobe-acrobat-sign-for-government
AEM インスタンスのリダイレクト URL を作成
- Forms as a Cloud Service のオーサーインスタンスで、ツール /一般/設定ブラウザー に移動します。
- 設定ブラウザー ページで「作成」を選択します。
- 設定を作成 ダイアログで、設定の タイトル を指定し、「クラウド設定」を有効にして「作成」を選択します。これにより、Cloud Services 用の設定コンテナが作成されます。フォルダー名にスペースが含まれていないことを確認します。
- ツール /Cloud Services/Adobe Acrobat Sign に移動し、上記の手順で作成した設定コンテナを開きます。アダプティブフォームを作成する際に、「設定コンテナ」フィールドにコンテナ名を指定します。
- 設定ページで「作成」を選択して、AEM Forms 内に Adobe Acrobat Sign の設定を作成します。
- 現在のブラウザーウィンドウの URL をメモ帳にコピーし、URL から
/ui#/aem
を削除します。この URL はre-direct URL
と呼ばれます。
次のセクションでは、re-direct URL
とScopes
を Adobe Sign チームと共有し、認証情報(クライアント ID とクライアントシークレット)を要求します。
リダイレクト URL とスコープを Adobe Sign チームと共有し、資格情報を受け取る
Adobe Acrobat Sign for Government Solutions チームには、AEM Forms と Adobe Acrobat Sign Solutions for Government との接続を可能にする資格情報(クライアント ID とクライアントの秘密鍵)を生成するために、Adobe Acrobat Sign アプリケーション(下記)で re-direct URL
および特定のスコープを有効にする必要があります。
前の節の最後の手順で作成して書き留めた scopes
(下記)と re-direct URL
を、Adobe Acrobat Sign for Government Solution 担当者(Adobe Professional Services チームメンバー)と共有します。
スコープ
- aggrement_read
- aggrement_write
- aggrement_send
- widget_read
- widget_write
- workflow_read
- offline_access
担当者が資格情報を生成し、共有します。次の節では、資格情報(クライアント ID とクライアントの秘密鍵)を使用して、AEM Forms を Adobe Acrobat Sign Solutions for Government に接続します。
受け取った資格情報を使用して、AEM Forms を Adobe Acrobat Sign Solutions for Government に接続する
-
ブラウザーで
re-direct URL
を開きます。「AEM インスタンスにリダイレクト URL を作成」セクションの最後の手順でre-direct URL
を作成し、書き留めました。 -
Adobe Sign 設定を作成 ページの「一般」タブで、設定の 名前 を指定して「次へ」を選択します。必要に応じて タイトル を指定し、設定の サムネ―ル を参照して選択することもできます。「次へ」をクリックします。
-
Adobe Sign 設定を作成 ページの「設定」タブの、「ソリューションを選択」オプションで、Adobe Acrobat Sign Solutions for Government を選択します。
-
「メール」フィールドで、Adobe Acrobat Sign Solutions for Government アカウントに関連付けられたメールアドレスを指定します。
-
「設定」タブで、
-
「OAuth URL」フィールドには、Adobe Sign データベースシャードを含むデフォルトの URL が含まれます。URL の形式は次の通りです。
https://<shard>/api/gateway/adobesignauthservice/api/v1/authorize
次に例を示します。
https://secure.na1.adobesign.us/api/gateway/adobesignauthservice/api/v1/authorize
-
トークン URL にアクセス フィールドには、Adobe Sign データベースシャードを含むデフォルトの URL が含まれます。URL の形式は次の通りです。
https://<shard>/api/gateway/adobesignauthservice/api/v1/token
次に例を示します。
https://secure.na1.adobesign.us/api/gateway/adobesignauthservice/api/v1/token
各パラメーターの意味は次のとおりです。
na1 は、デフォルトのデータベースシャードを参照します。データベースシャードの値を更新することができます。 Adobe Acrobat Sign クラウド設定で、正しいシャードをポイントしていることを確認します。
note note NOTE - Adobe Sign アカウントにログインした後、Acrobat Sign API/API 情報/REST API メソッドのドキュメント/OAuth アクセストークン に移動して、Adobe Sign oAuth URL とアクセストークン URL に関連する情報にアクセスします。
-
-
前の節で、Adobe Acrobat Sign for Government Solution 担当者([Adobe Professional Services チームメンバー])が共有した資格情報を [クライアント ID と クライアントの秘密鍵] として使用します。
-
「添付ファイルの Adobe Acrobat Sign を有効にする」オプションを選択すると、アダプティブフォームに添付されているファイルが、署名用に送信された対応する Adobe Acrobat Sign ドキュメントに添付されます。
-
「Adobe Sign に接続」を選択します。資格情報の入力画面が表示されたら、Adobe Acrobat Sign アプリケーションの作成時に使用したユーザー名とパスワードを入力します。
your developer account
へのアクセスを確認するメッセージが表示されたら、「アクセスを許可」をクリックします。資格情報が正しく、AEM Forms が Adobe Acrobat Sign 開発者アカウントにアクセスできるようにした場合は、次のような成功メッセージが表示されます。 -
「作成」を選択して、設定を作成します。
-
設定を選択し、「公開」をクリックします 。 これにより、対応するパブリッシュ環境に設定が複製されます。
-
開発者、ステージ、実稼動用のインスタンス(残っているいずれか)で上記の手順をすべて繰り返し、お使いの環境用に Adobe Acrobat Sign Solutions for Government を AEM Forms で設定する作業を完了します。
アダプティブフォームまたは AEM ワークフローに Adobe Acrobat Sign フィールドを追加できるようになりました。Adobe Acrobat Sign に対して有効化するすべてのアダプティブフォームに、クラウドサービス設定に使用する設定コンテナを必ず追加してください。設定コンテナは、アダプティブフォームのプロパティから指定できます。
Adobe Acrobat Sign スケジューラーを設定して署名ステータスを同期する configure-adobe-sign-scheduler-to-sync-the-signing-status
AEM Forms as a Cloud Service では、定義された間隔で署名者のステータスを確認するスケジューラーサービスを提供します。スケジューラーサービスを設定するシナリオを以下に示します。
- 「フォームを送信(すべての受信者が署名行為を完了した後)」を使用してドキュメントに署名した場合、フォームはすべての署名者がフォームに署名した後にのみ送信されます。
- 「AEM ワークフローの署名ステップ」を使用してドキュメントに署名した場合、署名ステップは、すべての署名者がドキュメントに署名するのを待ってから、ワークフローの次のステップに進みます。
デフォルトでは、Adobe Acrobat Sign スケジューラーサービスは、24 時間ごとに署名者の応答を確認(ポーリング)します。現在の環境に合わせて、このデフォルト値を変更することができます。
デフォルトの間隔を変更するには、Adobe Acrobat Sign 設定サービス の設定の sign.status.exp プロパティに cron 式を指定します。
例えば、毎日午前 0 時に設定サービスを実行するには、Adobe Acrobat Sign 設定サービス 設定の sign.status.exp プロパティを 0 0 0 1/1 * ? *
に指定します。次の JSON ファイルに、設定サービスを毎日午前 0 時に実行するサンプルを示します。
{
"sign.status.exp":"0 0 0 1/1 * ? *"
}
設定の値をセットするには、AEM SDK を使用して OSGi 設定を生成し、Cloud Service インスタンスに設定をデプロイします。