n8nで署名を自動化
n8nはセルフホスティング可能なオープンソース自動化プラットフォームです。Certyneo へのアクセス方法は2つあります。n8n に付属する Webhook と HTTP Request ノードのみを使用し、インストール不要のワークフロー実装をインポートするか、Certyneo ノードをパネルに統合したい場合は、コミュニティノード n8n-nodes-certyneo をインストールしてください。どちらの場合でも、API キーを貼り付ければ、署名イベントがスタック全体を制御します。
ワークフローはインストール不要です。n8nに付属するノードのみを使用するため、n8n Cloudを含むどこでも機能します。コミュニティノードn8n-nodes-certyneoはnpmで公開されており、自ホスティングインスタンス上のSettings→Community nodesからインストールされます。n8n Cloudは、n8nが検証したノードのみを提供します。
Certyneoをn8nに接続する理由
n8nは選択肢を提供します：マネージドサービスまたは独自のサーバー。どちらの場合でも、Certyneo統合は公開APIとWebhookを使用し、契約とツール間にプロプライエタリな仲介者はありません。
11個のイベント、4個ではなく
Webhookノードはエンベロープのライフサイクル全体を受け取ります。作成、送信、開封、署名、拒否、キャンセル、有効期限切れ、差し戻し。固定リストのコネクタとは異なり、トリガーは一つも見落とされません。
すべてのAPI、待たずに
HTTP Requestノードは、存在するCertyneo APIの任意のエンドポイントを呼び出します。エンベロープの作成、送信、ドキュメントのアップロード、署名済みPDFまたは証拠フォルダの取得が可能です。
セルフホスティング可能
ホストするn8nインスタンス上では、契約のメタデータはいかなるサードパーティも経由しません。トラフィックはサーバーからCertyneoへのみ流れます。法務チームとIT部門にとって強力な利点です。
APIキーとHMAC署名
接続はスコープが限定され、いつでも取り消し可能なAPIキーで認証されます。受け取るイベントはHMAC-SHA256で署名されます。ワークフローはそれがCertyneoから来たことを検証できます。
利用可能なイベント
Webhookノードを選択したイベントにサブスクライブしてください。リアルタイムで到着し、n8n側で検証する署名ヘッダー（X-Certyneo-Signature）が含まれます。
| イベント | 以下の条件でトリガーが発動します… |
|---|---|
エンベロープ作成済みenvelope.created | エンベロープが作成されたばかりで、まだドラフト状態です。 |
封筒送信envelope.sent | エンベロープはドラフトを離れ、受取人へ送信されます。 |
封筒の署名完了envelope.completed | すべての受信者が署名しました。エンベロープは確定され、署名済み PDF のダウンロードリンクが付与されます。 |
封筒の拒否envelope.declined | 受取人が署名を拒否し、指定した理由が記載されます。 |
エンベロープキャンセルenvelope.voided | 送信者が既に送信したエンベロープをキャンセルします。署名リンクが使用できなくなります。 |
エンベロープの有効期限切れenvelope.expired | すべての受取人が署名する前に期限を超過しました。 |
エンベロープが送信者に返却されましたenvelope.returned_to_sender | 受取人が署名する代わりに、修正のためにエンベロープを返送します。 |
エンベロープ再送信envelope.resubmitted | 送信者が修正し、返却されたエンベロープを再度送信します。 |
受取人が署名recipient.signed | 受信者が署名を完了します。署名者ごとに1回トリガーされ、最終段階だけではありません。 |
受取人が開きましたrecipient.viewed | 受取人がエンベロープを初めて開きます。最適なタイミングで催促するのに役立ちます。 |
受取人が承認しましたrecipient.approved | ロールが「承認者」である受取人が、署名なしでエンベロープを検証します。 |
到達できないアドレスrecipient.bounced | 受取人のアドレスが永続的な失敗を返しています（メールボックスが存在しないか、ドメインが無効です）。リトライが停止されます。アドレスを修正してエンベロープを再送信してください。 |
管理可能な項目
各行は、Header Auth認証とCertyneo APIキーを使用したHTTP Requestノードの呼び出しです。
封筒作成
POST /envelopes — Certyneo テンプレートまたは既にアップロードされたドキュメントからエンベロープを作成し、受取人を設定します。
封筒を送信
POST /envelopes/:id/send — エンベロープを下書きから送信し、署名招待を送付します。
エンベロープをリスト表示
GET /envelopes — ページネーション付きリスト（最新順）、オプションのステータスフィルター付き。
ドキュメントをアップロード
POST /documents — n8nの任意のノードからPDFを送信します（メール添付ファイルまたはDriveファイルを含む）。
テンプレート一覧を取得
GET /templates — ワークフロー内でハードコードする必要がないよう、テンプレートIDを取得します。
署名付きPDFをダウンロード
GET /envelopes/:id/signed-document — 署名済み文書を取得し、/audit-trail で証拠ファイルを取得します。
連携の設定
当社が提供するワークフローには既にウェブフック、イベントベースのルーティング、サブスクリプション呼び出し、および送信例が含まれています。5分程度見積もってください。
- 1
ワークフローをインポート
n8nでワークフローメニューを開き、「Import from URL…」を選択してテンプレートアドレスを貼り付けてください。ファイルをダウンロードしてキャンバスにドラッグすることもできます。
- 2
APIキーの生成
Certyneo → 設定 → REST API を開き、エンベロープとウェブフック スコープを持つキーを作成します。コピーしてください。1 回だけ表示されます。
- 3
Header Auth認証情報を作成
n8nで「Header Auth」認証情報を追加してください。名前は「Authorization」、値は「Bearer」の後にAPIキーを指定します。ワークフローのHTTP RequestノードでこれらをSelected します。
- 4
購読してアクティブ化
Webhookノードの本番環境URLをコピーし、サブスクリプション呼び出しに貼り付けて1回実行した後、ワークフローをアクティブ化してください。返された「secret」を保管してください。これはイベント署名を検証するために使用されます。
- 5
Google Drive を接続
テンプレートは署名済み PDF と監査証拠をお客様の Drive に保存します。2 つのアーカイブノードで Google アカウントを選択してください。S3、SharePoint、またはその他のストレージに置き換えることもできます。同じバイナリフィールドを使用します。
安全と適合性
n8n統合はCertyneo公開APIに基づいており、プラットフォームの他の部分と同じレベルの要件があります。
- エンドツーエンドのHTTPS暗号化通信。
- スコープが限定されたAPIキー。必要な権限のみを付与します。
- 各イベントはHMAC-SHA256で署名されています — 処理する前に検証してください。
- ダッシュボードからいつでもキーを無効化できます。
よくある質問
n8nにCertyneoノードをインストールする必要がありますか？
必須ではありません。当社が公開するワークフローはn8nに付属するWebhookおよびHTTP Requestノードのみを使用します。インストール不要で、n8n Cloud上でも同等に機能します。コミュニティノード（npm上のn8n-nodes-certyneo、アクションノード、トリガーノード、そのidentifierを含む）が存在し、自ホスティングインスタンス上のSettings→Community nodesからインストールされます。n8nのドキュメントはn8n Cloudを検証済みのノードのみに予約しています。
n8nを使用するにはどのCertyneoサブスクリプションが必要ですか？
実キー(sk_live_…)にはAPI アクセスを含むプランが必要です(Standard以上)。FreeおよびPersonalプランはサンドボックスキー(sk_test_…)を備えており、署名者にメール送信せずにテストエンベロープで全フローを実行できます。
どのようにAPIキーを取得しますか？
Certyneo から、設定 → REST API に移動し、envelopes:read、envelopes:write、webhooks:write スコープを持つキーを作成します。これは sk_live_ (またはサンドボックスの場合は sk_test_) で始まり、1回だけ表示されます。すぐにコピーしてください。
自ホストのn8nインスタンスで機能しますか？
はい、これが最も興味深いユースケースです。インスタンスはインターネットから到達可能である必要があります。当社のウェブフックを受信するにはHTTPS公開URLで十分です。サードパーティサービスを経由してデータが流れることはありません。
どの署名イベントがカバーされていますか？
ライフサイクルの11イベント：エンベロープ作成、送信、署名、拒否、キャンセル、有効期限切れ、送信者へ返信、再提出、および受信者が開封、署名、または承認。購読するイベントを選択できます。
Certyneo からのイベントであることを確認する方法は？
各配信には、サブスクリプション作成時に返されたシークレットで計算されたリクエスト本体の HMAC-SHA256 を含む X-Certyneo-Signature ヘッダーが付与されます。イベント処理の前にコードノードで比較してください。
n8n インテグレーションは有料ですか？
Certyneo は追加料金を請求しません。n8n 側では、自社ホスト型インスタンスは無料です。n8n Cloud では、各実行がプランのクォータを消費します。
更に進める
今日、契約を自動化する
ワークフローをインポートし、API キーを貼り付けて、署名が残りの処理をトリガーするようにしてください。