Personr (プレビュー)
Personr を使用して申請者データを作成、検証、取得します。 簡単に本人確認を行い、複雑な詐欺を検出します。
このコネクタは、次の製品および地域で利用可能です:
| サービス | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure 中国の地域 - 国防総省 (DoD) |
| Power Automate | プレミアム | 以下を除くすべての Power Automate 地域 : - US Government (GCC) - US Government (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - US Government (GCC) - US Government (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| お問い合わせ先 | |
|---|---|
| 件名 | 姓名 |
| [URL] | https://personr.co/contact |
| メール | help@personr.co |
| Connector Metadata | |
|---|---|
| 発行者 | マイクロソフト |
| Web サイト | https://personr.co |
| プライバシー ポリシー | https://personr.co/legals |
| カテゴリー | 日付 |
Personr は、複雑な詐欺を検出しながら本人確認を簡素化し、ビジネスが顧客確認 (KYC) およびマネーロンダリング防止 (AML) 規制に準拠できるようにします。 コネクタを使用すると、申請者のステータスと詳細を作成、確認、要求できます。
前提条件
続行するには、次のものが必要です...
- アクティブな/購読済み Personr アカウント。 現在購読していない場合は、https://personr.co にアクセスするか、アカウントにログインしてプランを選択することで購読できます。
資格情報の入手方法
1 年間有効な承認ベアラー トークンを生成する必要があります。 これを行うには、POST 要求を https://enterprise.personr.co/api/1.1/wf/api-token-generate に送信します
本文にはアカウントのメール アドレスとパスワードを含める必要があります。 API は、次の例のように、認証ベアラー トークンを含む応答を返します。
{
"status": "success",
"response": {
"token": "your_auth_token",
"expires": "expiry_date_in_seconds"
}
}
設定中にコネクタにトークンを入力するときは、トークン Bearer your_auth_token の前に「ベアラー」という単語が含まれていることを確認してください。
コネクタの使用を開始する
最初の申請者の認証を開始するには、以下の方法に従ってください。
最初の申請者を作成します。
Create an Applicant action を使用して、メール、電話番号、希望するフローなどの必要な詳細を入力します。 名および姓を入力することもできます (オプション)。
注意: Flow Name は、プラットフォーム上で作成したものと一致する必要があります。
検証リンクを作成するか、ドキュメントを直接アップロードします。
申請者を確認するには、申請者に検証リンクを提供するか、base64 形式で書類を直接アップロードするという 2 つの方法があります。
検証リンクを生成するには、Create a Verification Link アクションを使用し、前のステップで受け取った申請者 ID を入力します。 検証リンクを使用すると、申請者は選択したフローに従って書類をアップロードできます。
検証リンクを使用する場合、検証のためにそれ以外のアクションは必要なく、処理は自動的に開始されます。
ドキュメントを申請者プロファイルに直接アップロードするには、Upload a Document アクションを使用して、申請者 ID、ドキュメント タイプ、サブ タイプ、ドキュメントの国、ファイル名、base64 コンテンツなどの必要な情報を入力します。
選択したフローに必要なドキュメント (表面と裏面) をアップロードしたら、Request an Applicant Check アクションを使用して確認し、処理を開始します。 検証リンクの方法を使用している場合、処理が自動的に開始されるため、これは必要ありません。
注意: ファイル名にはファイル拡張子を含める必要があります (例: id_card.jpg) さらに、base64 コンテンツにはファイル タイプを含めないでください。 例: /9j/4AAQSkZJRgABAQAAAQABAAD...
ドキュメント タイプとサブタイプの詳細については、次の公開ドキュメントを参照してください: https://documenter.getpostman.com/view/23863579/2s8YzWSLzB#799aec14-d363-4c97-9447-9d20832b75dd
申請者のステータスと抽出された情報を取得します。
通常、検証の処理には約 2 分かかります。 申請者のステータスを取得するには、関連する applicantId を指定して Retrieve Applicant Status アクションを使用します。
このアクションにより、Approved または Rejected 回答、拒否ラベル、および抽出されたドキュメント情報が提供されます。
申請者の詳細を取得します。 (任意)
上記のアクションと同様に、Retrieve Applicant Details を使用すると、関連付けられた applicantId を使用して、申請者に関する追加情報を取得できます。
既知の問題と制限事項
画像が極端にぼやけていたり、焦点が合っていない場合、検証は続行されません。 JPEG、PNG、PDF のファイル タイプをサポートします。
一般的なエラーと解決策
Create an Applicant アクションを使用するときにエラーが発生した場合は、フロー名がプラットフォームで作成したものと一致していることを確認してください。
Upload a Document アクションを使用して自撮り画像をアップロードする場合 (フローで必要な場合)、ドキュメント タイプが "SELFIE"、ドキュメント SubType が "NULL" であることを確認してください。
よくあるご質問
申請者のデータはどのように検証されますか?
抽出された申請者のデータは、選挙人名簿、車両、通信事業者、死亡、その他の登録簿を含むがこれらに限定されない、精査された政府および商業データベースと照合されます。
複雑な不正行為の検出またはデジタル操作とは何ですか?
複雑な不正行為の検出、またはデジタル操作の検出は、ドキュメントがグラフィカルに編集、偽造、オンラインで違法に購入されていないかどうかを確認するプロセスです。 このプロセスは検証ごとにバックグラウンドで実行され、不正行為が発生する前に防止し、企業と個人を保護するのに役立ちます。
自分のビジネスに使用できるカスタム フローを作成できますか?
もちろんです。まったく同じビジネスはありません (そしてどの検証も同様です)。 マイクロソフトのチームにお問い合わせください。お客様の要件に合わせたカスタム フローを作成いたします。
検証にはどの国がサポートされていますか?
言語や活字に関係なく、運転免許証から公共料金請求書、銀行取引明細書、さらには政府当局との通信に至るまで、ドキュメントと個人を世界中で検証します。
接続を作成する
このコネクタは、次の認証タイプをサポートしています:
| 既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 件名 | タイプ | プロパティ | 必須 |
|---|---|---|---|
| 認証トークン | securestring | 認証ベアラー トークンを入力します | True |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| アプリケーションを作成する |
新しいアプリケーションを作成します。 |
| 検証リンクの作成 |
検証リンクを作成して、ドキュメントを簡単にアップロードします。 |
| 申請者にドキュメントをアップロードする |
Base64 文字列を使用してドキュメントを申請者にアップロードします。 |
| 申請者のステータスの取得 |
申請者の検証ステータスとその詳細を取得します。 |
| 申請者の詳細を取得する |
申請者の詳細を取得します。 |
| 申請者チェックの要求 |
すべてのドキュメントがアップロードされていることを確認し、チェックを開始します。 |
アプリケーションを作成する
新しいアプリケーションを作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
電子メールアドレス
|
string |
メールアドレス |
||
|
電話番号
|
phone | string |
電話番号 |
|
|
名
|
nameFirst | string |
nameFirst |
|
|
姓
|
nameLast | string |
nameLast |
|
|
申請者フロー
|
flowName | string |
flowName |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ステータス
|
status | string |
ステータス |
|
applicantId
|
response.applicantId | string |
applicantId |
|
メールアドレス
|
response.email | string |
メールアドレス |
|
電話番号
|
response.phone | string |
電話番号 |
|
nameFirst
|
response.nameFirst | string |
nameFirst |
|
nameLast
|
response.nameLast | string |
nameLast |
|
flowName
|
response.flowName | string |
flowName |
|
applicantStatus
|
response.applicantStatus | string |
applicantStatus |
検証リンクの作成
検証リンクを作成して、ドキュメントを簡単にアップロードします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
申請者 ID
|
applicant | string |
申請者 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ステータス
|
status | string |
ステータス |
|
verificationLink
|
response.verificationLink | string |
verificationLink |
申請者にドキュメントをアップロードする
Base64 文字列を使用してドキュメントを申請者にアップロードします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
申請者 ID
|
applicantId | string |
applicantId |
|
|
ドキュメントの種類 (例 ID_CARD)
|
docType | string |
docType |
|
|
ドキュメントのサブタイプ (例 FRONT_SIDE)
|
docSubType | string |
docSubType |
|
|
ドキュメントの国 ISO (例 オーストラリア)
|
docCountryISO | string |
docCountryISO |
|
|
ファイル名 + 拡張機能 (例 document.jpeg)
|
filename | string |
ファイル名 |
|
|
ファイル コンテンツ (Base64 文字列)
|
contents | string |
目次 |
戻り値
申請者のステータスの取得
申請者の検証ステータスとその詳細を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
申請者 ID
|
applicantId | string |
applicantId |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ステータス
|
status | string |
ステータス |
|
applicantStatus
|
response.applicantStatus | string |
applicantStatus |
|
applicantActionStatus
|
response.applicantActionStatus | string |
applicantActionStatus |
|
変更日
|
response.result.Modified Date | integer |
変更日 |
|
作成日
|
response.result.Created Date | integer |
作成日 |
|
作成者
|
response.result.Created By | string |
作成者 |
|
reviewAnswer
|
response.result.reviewAnswer | string |
reviewAnswer |
|
申請者
|
response.result.applicant | string |
申請者 |
|
commentClient
|
response.result.commentClient | string |
commentClient |
|
会社名
|
response.result.company | string |
会社名 |
|
commentModeration
|
response.result.commentModeration | string |
commentModeration |
|
rejectLabels
|
response.result.rejectLabels | array of string |
rejectLabels |
|
reviewRejectType
|
response.result.reviewRejectType | string |
reviewRejectType |
|
確認
|
response.result.verification | string |
確認 |
|
_id
|
response.result._id | string |
_id |
|
extractedFirstName
|
response.extractedFirstName | string |
extractedFirstName |
|
extractedLastName
|
response.extractedLastName | string |
extractedLastName |
|
extractedBirthDate
|
response.extractedBirthDate | string |
extractedBirthDate |
|
documentCountry
|
response.documentCountry | string |
documentCountry |
|
extractedStreetNum
|
response.extractedStreetNum | string |
extractedStreetNum |
|
extractedStreet
|
response.extractedStreet | string |
extractedStreet |
|
extractedCity
|
response.extractedCity | string |
extractedCity |
|
extractedState
|
response.extractedState | string |
extractedState |
|
extractedPostCode
|
response.extractedPostCode | string |
extractedPostCode |
申請者の詳細を取得する
申請者の詳細を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
申請者 ID
|
applicantId | string |
applicantId |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ステータス
|
status | string |
ステータス |
|
メールアドレス
|
response.email | string |
メールアドレス |
|
電話番号
|
response.phone | string |
電話番号 |
|
nameFirst
|
response.nameFirst | string |
nameFirst |
|
nameLast
|
response.nameLast | string |
nameLast |
|
タグ
|
response.tags | array of |
タグ |
|
flowName
|
response.flowName | string |
flowName |
|
ステータス
|
response.status | string |
ステータス |
申請者チェックの要求
すべてのドキュメントがアップロードされていることを確認し、チェックを開始します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
申請者 ID
|
applicantId | string |
applicantId |