Certyneo (プレビュー)

eIDAS 準拠の電子署名用のドキュメントを送信し、テンプレートからエンベロープを作成し、送信、署名、完了、拒否などの署名イベントのフローをトリガーします。

このコネクタは、次の製品とリージョンで使用できます。

サービス クラス Regions
コピロット スタジオ Premium 次を除くすべての Power Automate リージョン :
     - 米国政府 (GCC)
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
ロジック アプリ Standard 次を除くすべての Logic Apps リージョン :
     - Azure Government リージョン
     - Azure China リージョン
     - 米国国防総省 (DoD)
Power Apps Premium 次を除くすべての Power Apps リージョン :
     - 米国政府 (GCC)
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
Power Automate(パワーオートメート) Premium 次を除くすべての Power Automate リージョン :
     - 米国政府 (GCC)
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
お問い合わせ
Name Certyneo のサポート
URL https://certyneo.com/fr/contact
Email support@certyneo.com
コネクタ メタデータ
発行元 Certyneo
Web サイト https://certyneo.com
プライバシー ポリシー https://certyneo.com/fr/legal/privacy
カテゴリ IT 運用;生産性

Certyneo

Certyneo は、eIDAS に準拠した電子署名サービスです。 このコネクタを使用すると、フローは署名のためにドキュメントを送信し、署名者が行動したときにリアルタイムで対応し、署名済みの PDF とその証拠ファイルを、他の企業が記録を保持する場所であればどこでも提出できます。

一般的なフローは、ドキュメントがどこか (ドキュメント ライブラリ、メールボックス、フォームの送信) に着陸し、フローが封筒を作成して送信し、 envelope.completed によってトリガーされる 2 つ目のフローが署名済み PDF をダウンロードして保存する 3 つの手順です。

発行元

Certyneo

Prerequisites

API アクセスを含むプランに Certyneo アカウントが必要です。 無料プランと個人用プランでは、API キーを作成してイベントをサブスクライブできますが、サンドボックス エンベロープのイベントのみを受信します。以下の 既知の問題と制限事項 を参照してください。

資格情報を取得する方法

コネクタは Certyneo API キーを使用して認証します。

  1. Certyneo にサインインし 、[設定] → API キーを開きます。
  2. キーを作成します。 ライブ キーは sk_live_で始まり、サンドボックス キーは sk_test_ で始まります。
  3. コネクタが API キーを要求したら、 Bearerという単語、スペース、キー ( Bearer sk_live_abc123など) を貼り付けます。 Certyneo はキーの前に Bearer という単語を想定しており、単独で貼り付けたキーは 401 で拒否されます。

キーにはスコープが含まれます。 envelopes:writeを持たないキーは作成または送信できず、webhooks:writeを持たないキーはトリガーを返すことができません。 フローが実際に必要とするスコープを付与します。

メールを送信せずにテストする

サンドボックス キー (sk_test_) は、1 つの招待メールを送信せずにパイプライン全体を実行します。 実際の受信トレイに到達するものはありません。つまり、誰も電子メールから署名ページにアクセスできないため、 封筒を作成 して 封筒を送信 すると、各受信者の アクセス トークン が返されます。 https://certyneo.com/sign/<access token>を開き、自分でテスト エンベロープに署名します。

そのトークンを資格情報として扱います。トークンを保持しているユーザーは誰でも、その受信者として署名できます。 ログに記録しないでください。また、スプレッドシートにドロップしないでください。

サポートされている操作

Trigger

エンベロープ イベントが発生すると 、選択したイベントに対して発生し、ポーリングではなく実際の Webhook によってサポートされます。 使用可能なイベント:

envelope.created、 envelope.sent、 envelope.completed、 envelope.declined、 envelope.voided、 envelope.expired、 envelope.returned_to_sender、 envelope.resubmitted、 recipient.signed、 recipient.viewed、 recipient.approved。

すべてのペイロードには、エンベロープイベントと受信者イベントの両方にエンベロープ ID が含まれます。 これは、以下のアクションにフィードする値です。

配信は、 X-Certyneo-Signature ヘッダー (生の JSON 本文の 16 進ダイジェスト) に HMAC-SHA256 で署名され、サブスクリプション シークレットでキーが設定されます。 フローがペイロードに対して動作する前に確認します。

Actions

アクション それが何をするか
テンプレートの一覧を表示します。 保存した封筒テンプレート。 テンプレート ピッカーの機能を提供します。
封筒を作成する テンプレートまたはアップロードされたドキュメントから DRAFT エンベロープを作成します。
封筒を送信する DRAFT エンベロープを受信者にディスパッチします。
封筒を取得する 現在の状態と受信者の詳細。
封筒を一覧表示する ページ分割されたリスト。状態でフィルター処理できます。
ドキュメントをアップロードする PDF または画像をアップロードし、ドキュメント ID を返します。
署名されたドキュメントをダウンロードする 署名済み PDF、証明書ページが含まれています。
監査証跡のダウンロード 証拠ファイル: 署名したユーザー、いつ、どの IP から、どの要因を持つか。
下書き封筒を削除する 送信されなかった封筒を削除します。

既知の問題と制限事項

送信されたエンベロープをフローから取り消すことはできません。下書き封筒を削除 すると、下書きのままの封筒 (途中で失敗したフロー、間違ったドキュメント) のみが受け入れられます。 エンベロープが外に出ると 409 が返され、現在の API にはキャンセル操作はありません。

recipient.signed 署名済み PDF が存在する前に発生します (最後の署名者を含む)。 最終的なドキュメントのアセンブルとシールは、そのイベントの後に行われるため、 recipient.signed でトリガーされ、直ちに 署名されたドキュメントのダウンロード を呼び出すフローは毎回 409 になります。 これは遅延で勝てるレースではありません - 代わりに envelope.completed でトリガーされ、PDFがディスク上にあると起動します。

無料プランと個人用プランはサンドボックス イベントのみを受け取ります。 どちらもサブスクリプションを作成でき、トリガーは正常と表示されますが、ライブ エンベロープはそれに到達しません。 トリガーが実際のトラフィックに対して何も行っていないように見える場合は、何よりも前にプランを確認します。

テンプレートまたはドキュメントを使用します。両方を使用しないでください。 テンプレートには、独自のドキュメント と 独自の署名フィールドが用意されています。 アップロードしたドキュメントからビルドする場合は、 フィールド も指定する必要があります。署名者が署名する場所がない封筒は、作成時ではなく、送信時に 409 signer_without_fieldで拒否されます。

座標よりもアンカー テキストを優先します。 ドキュメント ("Signature du client") から語句を引用してフィールドを配置すると、レイアウトの変更に耐え、測定する必要はありません。 X と Y はフォールバックとして残るので、アンカーが見つからないフィールドは、消える代わりにリテラル位置を保持します。

アップロードの上限はドキュメントあたり 50 MB です。

消去されたドキュメントは、409 ではなく 410 を返します。 409 は、"まだ準備ができていません、 envelope.completed後に戻ってくる" を意味します。 410 は、署名されたドキュメントがアイテム保持ポリシーの下で意図的に削除され、戻ってこないことを意味します。 再試行ループは 410 であきらめる必要があります。

一般的なエラーと解決方法

応答 原因 対処法
401 キーが見つからないか、前面に Bearer なしで貼り付け 次のように接続を再入力します。 Bearer sk_live_...
403 キーにこの操作のスコープがありません フローに必要なスコープでキーを再発行する
ダウンロード時の 409 封筒はまだ完了していません ポーリングではなく envelope.completed でトリガーする
送信時に 409 signer_without_field — 署名者に署名フィールドがありません フィールドの追加、またはテンプレートからのビルド
削除時に 409 封筒は既に送信されています 送信された封筒を削除または取り消すことはできません
ダウンロード時に 410 アイテム保持ポリシーの下でドキュメントが消去されました 再試行を停止します。ファイルが消えました

エラーには、人間が判読できる error メッセージと安定した codeの両方が含まれます。 code上の分岐 — メッセージを語り直すことができます。

Support

接続を作成する

コネクタでは、次の認証の種類がサポートされています。

デフォルト 接続を作成するためのパラメーター。 すべてのリージョン 共有できません

デフォルト

適用対象: すべてのリージョン

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

Name タイプ Description 必須
API キー securestring この API の API キー True

アクション

テンプレートの一覧を表示します。

保存した封筒テンプレートを返します。 [封筒の作成] でテンプレート ピッカーの電源をオンにするために使用されます。

ドキュメントをアップロードする

PDF または画像をアップロードします (最大 50 MB)。 ドキュメント ID を返します。[ドキュメント] の下の [封筒の作成] に渡します。

下書き封筒を削除する

送信されなかったエンベロープ (途中で失敗したフロー、間違ったドキュメント) を削除します。 下書きのみ: 封筒が外に出た場合、エラーが返され、フローから呼び出すことはできません。

封筒を一覧表示する

ページ分割された封筒の一覧を取得します。

封筒を作成する

保存したテンプレートから、または "ドキュメントのアップロード" でアップロードしたドキュメントから直接、DRAFT 状態で新しい封筒を作成します。 "テンプレート" または "ドキュメント" のいずれかを入力します。 ドキュメントでは、"フィールド" を追加して、各署名者が署名する場所を持つようにします。最も簡単な方法は、座標を処理するのではなく、"アンカー テキスト" でドキュメントの語句を引用符で囲む方法です。 重要: このアクションではエンベロープのみが作成されます。メールはまだ送信されません。 フローのこの直後に "封筒を送信する" アクションを追加して、実際に受信者にディスパッチします。

封筒を取得する

封筒の現在の状態と詳細を取得します。

封筒を送信する

署名のために DRAFT エンベロープを受信者にディスパッチします。これは、実際に電子メールを送信する手順です。 "封筒の作成" は下書きとしてのみ保存します。それ自体では何も送信しません。 フロー内の "封筒を作成する" 直後に、返されたエンベロープ ID を使用して、常にこのアクションをチェーンします。

監査証跡のダウンロード

完成したエンベロープの証拠ファイルを取得します。署名したユーザー、いつ、どの IP から、どの認証要素を使用したか。 署名されたPDFと一緒にアーカイブしてください:それはeIDAS紛争がオンになっているものです。

署名されたドキュメントをダウンロードする

署名された PDF の証明書ページを取得します。 エンベロープが完了した後にのみ、409 が返されるため、ポーリングではなく "エンベロープ完了" でトリガーされます。

テンプレートの一覧を表示します。

保存した封筒テンプレートを返します。 [封筒の作成] でテンプレート ピッカーの電源をオンにするために使用されます。

返品

ドキュメントをアップロードする

PDF または画像をアップロードします (最大 50 MB)。 ドキュメント ID を返します。[ドキュメント] の下の [封筒の作成] に渡します。

パラメーター

Name キー 必須 型 説明
ファイル
file True file

アップロードする PDF または画像(最大 50 MB)。

ドキュメント名
name string

ドキュメントの下にファイルする名前。 既定では、アップロードされたファイルの独自の名前が使用されます。

返品

Body
Document

下書き封筒を削除する

送信されなかったエンベロープ (途中で失敗したフロー、間違ったドキュメント) を削除します。 下書きのみ: 封筒が外に出た場合、エラーが返され、フローから呼び出すことはできません。

パラメーター

Name キー 必須 型 説明
封筒 ID
id True string

削除する下書き封筒の識別子。

返品

封筒を一覧表示する

ページ分割された封筒の一覧を取得します。

パラメーター

Name キー 必須 型 説明
ページ
page integer

返す結果のページ。 1 から始まります。

ページ サイズ
limit integer

1 ページあたりに返す封筒の数。

地位
status string

この状態の封筒のみを返します。 すべての状態を返すには、空のままにします。

返品

封筒を作成する

保存したテンプレートから、または "ドキュメントのアップロード" でアップロードしたドキュメントから直接、DRAFT 状態で新しい封筒を作成します。 "テンプレート" または "ドキュメント" のいずれかを入力します。 ドキュメントでは、"フィールド" を追加して、各署名者が署名する場所を持つようにします。最も簡単な方法は、座標を処理するのではなく、"アンカー テキスト" でドキュメントの語句を引用符で囲む方法です。 重要: このアクションではエンベロープのみが作成されます。メールはまだ送信されません。 フローのこの直後に "封筒を送信する" アクションを追加して、実際に受信者にディスパッチします。

パラメーター

Name キー 必須 型 説明
Subject
subject True string

封筒の件名/タイトル。

Message
message string

受信者に表示されるメッセージ。

Template
templateId string

保存したテンプレートを選択します。 この OR "Documents" (両方ではなく) を使用します。テンプレートには、独自のドキュメントと署名フィールドが用意されています。

Documents
documentIds array of string

"ドキュメントのアップロード" からのドキュメント ID。 両方ではなく、この OR "テンプレート" を使用します。 ドキュメントを使用する場合は、"フィールド" も追加します。署名者に署名欄がない封筒は、送信時に拒否されます。

署名者の電子メール
recipientEmail True string

上記のいずれかの受信者と正確に一致する必要があります。

ドキュメント番号
documentIndex integer

このフィールドを持つドキュメントは、上記の順序で 0 からカウントされます。 ドキュメントが 1 つしかない場合は空のままにします。

ページ
pageNumber True integer
フィールドの種類
fieldType True string
アンカー テキスト (推奨)
anchorText string

文書内で検索するテキスト — フィールドはその横に配置されるため、座標は必要ありません。 大文字と小文字が区別されず、PDF が複数の実行にまたがってフレーズを分割した場合でも検出されます。 代わりに X/Y を使用するには、空のままにします。

アンカーの配置
anchorPlacement string

アンカー テキストを基準にフィールドを配置する場所。

アンカーの出現
anchorIndex integer

アンカー テキストが複数回出現する場合に、使用する出現回数を 0 からカウントします。

X
x True number

左端からのポイント。 アンカーが見つかった場合は無視されます。フォールバックとして保持されるため、フィールドが消えることはありません。

ジー
y True number

上端からのポイント。 アンカーが見つかった場合は無視され、フォールバックとして保持されます。

幅
width True number
高さ
height True number
受信者の電子メール
email True string
受信者名
name string
Role
role string
状態
status string
signedAt
signedAt string
アクセス トークン
accessToken string

この受信者の署名ページを https://certyneo.com/sign/<token> で開きます。 サンドボックスでは招待メールが送信されないため、テスト エンベロープに自分で署名する方法です。 "封筒の作成" と "封筒の送信" によって返されます。"封筒の取得" ではなく、空のままです。 資格情報として扱います。保持するすべてのユーザーがこの受信者として署名できるため、ログに記録したり、スプレッドシートにドロップしたりしないでください。

署名レベル
signatureLevel string
有効期限:
expiresAt date-time
カテゴリ
category string

封筒一覧に表示されるビジネス分類。 空のままにすると、Certyneo は件名から 1 つを推論します。

タグ
tags array of string

自由形式のラベル - プロジェクト コード、顧客参照、内部状態。 最大 10 文字、それぞれ最大 40 文字。 サーバー側の小文字と重複除去。

Language
locale string

署名者に表示されるすべての言語:署名ページ、招待、リマインダー、完了メール。 BCP-47 コード (nl、nl-BE、en-GB、de、fr など)。 封筒を送信する Certyneo アカウントの言語を継承するには、空のままにします。 サポートされていないコードは、400 で拒否されます。

リダイレクトURL
redirectUrl string

署名後に署名者が送信される場所。 既定の Certyneo の行動喚起を、ここで指す 1 つの [続行] ボタンに置き換えます。 https:// から始める必要があります。それ以外の場合は 400 で拒否されます。

すべてのページのイニシャル
initialsOnEveryPage boolean

自分で配置したフィールドに加えて、すべてのドキュメントのすべてのページの下部にある署名者のイニシャルに自動的にスタンプを付けます。 ページごとのセットアップは必要ありません。署名者はイニシャルを 1 回入力し、あらゆる場所に適用されます。 署名者が既にフィールドを持っているページ (たとえば、最後のページの署名) をスキップします。

Workspace
workspaceId string

共有ワークスペース内にエンベロープを作成して、そのワークスペースのすべてのメンバーがそのエンベロープを表示してフォローアップできるようにします。 自分のアカウントに保持するには、空のままにします。 ワークスペースを所有しているか、ワークスペースのメンバーである必要があります。

返品

Body
Envelope

封筒を取得する

封筒の現在の状態と詳細を取得します。

パラメーター

Name キー 必須 型 説明
封筒 ID
id True string

取得するエンベロープの識別子。

返品

Body
Envelope

封筒を送信する

署名のために DRAFT エンベロープを受信者にディスパッチします。これは、実際に電子メールを送信する手順です。 "封筒の作成" は下書きとしてのみ保存します。それ自体では何も送信しません。 フロー内の "封筒を作成する" 直後に、返されたエンベロープ ID を使用して、常にこのアクションをチェーンします。

パラメーター

Name キー 必須 型 説明
封筒 ID
id True string

受信者にディスパッチする下書き封筒の識別子。

返品

Body
Envelope

監査証跡のダウンロード

完成したエンベロープの証拠ファイルを取得します。署名したユーザー、いつ、どの IP から、どの認証要素を使用したか。 署名されたPDFと一緒にアーカイブしてください:それはeIDAS紛争がオンになっているものです。

パラメーター

Name キー 必須 型 説明
封筒 ID
id True string

監査証跡をダウンロードするエンベロープの識別子。

返品

response
binary

署名されたドキュメントをダウンロードする

署名された PDF の証明書ページを取得します。 エンベロープが完了した後にのみ、409 が返されるため、ポーリングではなく "エンベロープ完了" でトリガーされます。

パラメーター

Name キー 必須 型 説明
封筒 ID
id True string

署名されたドキュメントをダウンロードする封筒の識別子。

返品

response
binary

トリガー

エンベロープ イベントが発生した場合

選択したイベントのいずれかが封筒で発生するたびにフローをトリガーします (署名済み、完了済み、拒否済みなど)。 リアルタイム Webhook によってサポートされます。ポーリングはありません。

エンベロープ イベントが発生した場合

選択したイベントのいずれかが封筒で発生するたびにフローをトリガーします (署名済み、完了済み、拒否済みなど)。 リアルタイム Webhook によってサポートされます。ポーリングはありません。

パラメーター

Name キー 必須 型 説明
Events
events True array of string

このフローをトリガーするエンベロープ/受信者イベント。

返品

X-Certyneo-Signature ヘッダーで HMAC-SHA256 で署名されて配信されます (生の JSON 本文の 16 進ダイジェスト。サブスクリプションのシークレットでキー付けされます)。 それに対して動作するフロー内のペイロードを信頼する前に確認します (/developers/webhook を参照)。

定義

DeleteResult

Name パス 型 説明
Success
success boolean

True リソースが削除されたとき。

Pagination

Name パス 型 説明
total
total integer
ページ
page integer
pageSize
pageSize integer
pages
pages integer

Template

Name パス 型 説明
id
id string
名前
name string
description
description string
signerCount
signerCount integer
documentCount
documentCount integer

TemplateList

Name パス 型 説明
データ
data array of Template
改ページ位置の自動修正
pagination Pagination

Recipient

Name パス 型 説明
受信者の電子メール
email string
受信者名
name string
Role
role string
状態
status string
signedAt
signedAt string
アクセス トークン
accessToken string

この受信者の署名ページを https://certyneo.com/sign/<token> で開きます。 サンドボックスでは招待メールが送信されないため、テスト エンベロープに自分で署名する方法です。 "封筒の作成" と "封筒の送信" によって返されます。"封筒の取得" ではなく、空のままです。 資格情報として扱います。保持するすべてのユーザーがこの受信者として署名できるため、ログに記録したり、スプレッドシートにドロップしたりしないでください。

ドキュメント

Name パス 型 説明
id
id string
名前
name string
mimeType(マイムタイプ)
mimeType string
size
size integer
状態
status string

Envelope

Name パス 型 説明
id
id string
subject
subject string
メッセージ
message string
状態
status string
signatureLevel
signatureLevel string
recipients
recipients array of Recipient
expiresAt
expiresAt string
createdAt
createdAt string
completedAt
completedAt string

EnvelopeList

Name パス 型 説明
データ
data array of Envelope
改ページ位置の自動修正
pagination Pagination

WebhookEventPayload

X-Certyneo-Signature ヘッダーで HMAC-SHA256 で署名されて配信されます (生の JSON 本文の 16 進ダイジェスト。サブスクリプションのシークレットでキー付けされます)。 それに対して動作するフロー内のペイロードを信頼する前に確認します (/developers/webhook を参照)。

Name パス 型 説明
イベント
event string
timestamp
timestamp date-time
封筒 ID
data.envelopeId string

常に存在します。 "封筒の取得" または "署名済みドキュメントのダウンロード" にフィードします。

Subject
data.subject string

エンベロープ イベントにのみ表示されます。

地位
data.status string
署名レベル
data.signatureLevel string

envelope.completed と recipient.signed に表示されます。

個人キーを持つ高度な署名署名者
data.aesSignerCount integer

envelope.completed on an ADVANCED envelope only.

高度な署名証明書のシリアル
data.aesCertificateSerial string

recipient.signed。署名者が個人の高度な署名キーで署名したとき。

高度な署名証明書 SHA256
data.aesCertificateSha256 string

recipient.signed。署名者が個人の高度な署名キーで署名したとき。

高度な署名マニフェスト SHA256
data.aesManifestSha256 string

recipient.signed。署名者が個人の高度な署名キーで署名したとき。

高度な署名のタイムスタンプ
data.aesTimestamped boolean

recipient.signed。署名者が個人の高度な署名キーで署名したとき。

受信者の数
data.recipientCount integer

エンベロープ イベントにのみ表示されます。

署名された数
data.signedCount integer

エンベロープ イベントにのみ表示されます。

受信者 ID
data.recipientId string

受信者のイベントにのみ表示されます。

受信者の電子メール
data.email string

受信者のイベントにのみ表示されます。

受信者名
data.name string

受信者のイベントにのみ表示されます。

受信者ロール
data.role string

受信者のイベントにのみ表示されます。

署名済み
data.signedAt date-time

受信者のイベントにのみ表示されます。

表示日
data.viewedAt date-time

受信者のイベントにのみ表示されます。

binary

これは基本的なデータ型 'binary' です。