OneSpan Sign Developer:アカウントの招待とパスワードのリセット

Duo Liang, 2018年8月29日
Thumbnail

以前のブログでは、「 送信者パッケージの取得 」、私たちは周りの概念とその違いを議論しましたアカウント所有者そしてアカウントメンバー(送信者) 。アカウントの所有者として、異なるメールの送信者を追加すると、トランザクションを個別に送信して処理する機能が付与されるため、非常に便利です。ここでは、メインアカウントに送信者を招待/作成する方法を詳しく見ていきます。

次の図は、RESTまたはSDKメソッドを使用して送信者を招待する方法を示しています。

8-30-1

注意:

発生する可能性のある最も一般的なエラーメッセージは次のとおりです。 

{"messageKey": "error.validation.senderAlreadyMemberOfAnother"、"message": "送信者はすでに別のアカウントのメンバーです。"、"code":400、"name": "検証エラー"}

Sandbox US V11などの単一のポータル環境では、1つのメールは1つのメインアカウントでのみ送信者になることができます。したがって、このエラーは、既にアカウント所有者またはアカウントメンバーになっている電子メールアカウントを招待しているために発生します。

しかし、本番環境で稼働し、新しい環境で同じメールを使用して送信者を作成する準備ができていれば問題ありません。前述の制限によると、サンドボックスとPRODは異なる環境であるため、アカウントは相互に独立しています。

「INVITED」と「ACTIVE」

上記の例では、送信者を追加するための標準的なワークフローである「INVITED」のステータスで、新しい送信者をアカウントに招待しました。OneSpan Signでは、送信者がパスワードと基本プロファイルを設定する必要がない場合は、招待メールをスキップして、送信者を「ACTIVE」ステータスで直接追加することもできます。これらの2つの概念を個別に説明します。

INVITED:INVITEDステータスは保留中のステータスであり、OneSpan Signは招待者の電子メールに電子メールを送信し、送信者に姓、名、パスワードなどの基本的なユーザー情報の入力を求めます。この情報が送信されると、新しい送信者のステータスが「ACTIVE」に変わります。

注意:

OneSpan Signに最初から登録されていた姓名は、ユーザーが招待されたときにユーザーが実際に入力したもので上書きされます。

アクティブ:INVITEDステータスの送信者を作成する代わりに、ユーザー情報を要求したり、パスワードの作成を要求したりせずに、送信者のステータスを直接ACTIVEに設定できます。これにより、アカウントの機能が制限されることはありません。送信者のAPIキーを取得して、送信者のAPIを呼び出すことができます。これら2つのアプローチの主な違いは、すぐにACTIVEに設定された送信者には、設定されたパスワードがないことです。これにより、送信者は現在Webポータルにログオンできなくなります。

招待メールを手動で送信するには、次のAPIを呼び出します。

POST / api / account / senders / {roleID} / invite

送信者のその他の管理については、送信者ガイド

パスワードのリセット

パスワードをリセットする必要がある場合は、Webポータルのログインページで[パスワードをお忘れですか]をクリックして、アカウントのメールアドレスを入力できます。それに応じて、パスワード再設定メールが送信されます。OneSpan Signには、このためのAPIインターフェイスがあります。

HTTPリクエスト

POST / api / account / senders / {roleID} / resetpassword

HTTPヘッダー

承諾:application / json

承認:基本的なapi_key

注意:

このAPIは、送信者のメールアドレスにリセットメールを送信するためのものです。パスワードを直接変更することはありません。

Webポータルとは異なり、どのアカウントにもリセットメールを送信できます。このAPIを使用すると、アカウント所有者の送信者にのみリセットメールを送信でき、メインアカウントや他のアカウントの送信者には送信できません。

両方のメールテンプレートアカウント招待そしてパスワードの再設定リクエスト sign.supportでサポートチームに連絡すると、カスタマイズできます@onespan .com。

電子メールからパスワードをリセットする以外に、Web UIダッシュボードでパスワードを変更することもできます。「マイアカウント」ページの「パスワード」セクションでは、現在のパスワードを入力してアカウントのパスワードを変更できます。

8-30-2

このブログや、OneSpan Signをアプリケーションに統合することに関するその他の質問がある場合は、開発者コミュニティフォーラム 。あなたのフィードバックは私たちにとって重要です!