){kind=small}
RCSを認証ワークフローに統合する
所要時間：2 分
リッチ・コミュニケーション・サービス（RCS）は、Verifyブランディング、既読レシート、モバイルデータまたはWi-Fi経由での配信などの最新機能を備えたSMSの次の進化です。デフォルトでRCSをサポートするモバイルデバイスやキャリアが増えるにつれ、ユーザーはメッセージングアプリ内で直接、安全でシームレスなやり取りをますます期待するようになっています。
企業にとっては、RCSを通じて直接二要素認証（2FA）を可能にするという、強力な機会が開かれることになる。
このチュートリアルでは、RCSを認証ワークフローに統合する方法を学びます。 Vonage Verify APIを使用した認証ワークフローにRCSを統合する方法を学びます。.また、フォールバックパスを設定することで、ユーザーのデバイスやネットワークで RCS がサポートされていない場合、認証リクエストは自動的に SMS などの別のチャネルにフォールバックします。
npmとNodeをインストールした。
RCS機能を備えた携帯電話。
RCSは、SMSチャネルを強化したもので、AndroidやiPhoneのデフォルトのメッセージングアプリにWi-Fiやモバイルデータを介してメッセージを配信することができます。また、ブランド検証をサポートし、配信の遅延が少ない。RCSチャネルを使用するには RCSチャンネルRCSチャンネルを使用するには RCSエージェントまたは送信者IDが必要です。
A Verifyワークフローは、ユーザーの身元を認証するために作成される一連のステップである。これは、SMS、または本人確認に使用できるワンタイムパスワードコードを含むEメールメッセージの送信である。
最初に優先チャネルを使用し、最初の試行が失敗した場合に自動的に別のチャネルにフォールバックする認証ワークフローを構築することができます。SMS、Silent Authentication、Eメール、WhatsAppなど、送信可能なチャネルのリストがあります。
では Verifyワークフローを設定しよう。を設定してみよう。もしメッセージがうまく変換されなければ、リストの次のチャンネルが使われる。SMSはユビキタスで広く利用できるため、2番目のフォールバック・チャネルとして使用する。
APIにアクセスするには、必ずVonage APIアカウントにサインアップ/サインインしてください。
API設定ページを開く API設定ページを開き、Vonage API KeyとSecretにアクセスしてください。両者は以下のスクリーンショットのように表示されます。APIキーはページの上部にあり、APIシークレットにアクセスするには、"Account secret "サブセクションを参照してください。
注：以前に作成したAPIシークレットを覚えていない場合は、"+ Create new secret "をクリックし、安全に保存してください。
アプリケーションを作成するには アプリケーションの作成ページでアプリケーションの名前を定義します。
Webhooksを使用するAPIを使用する場合は、秘密鍵が必要です。Generate public and private key "をクリックすると、自動的にダウンロードが始まります。この鍵は紛失すると再ダウンロードできません。この鍵は紛失しても再ダウンロードできません。 private_<あなたのアプリID>.key.この鍵はAPIコールの認証に使用できます。 注意：アプリケーションを保存するまで、キーは機能しません。
必要な機能（Voice、Messages、RTCなど）を選択し、必要なWebhook（イベントURL、応答URL、受信メッセージURLなど）を提供します。これらはチュートリアルで説明します。
保存してデプロイするには、"Generate new application "をクリックして設定を確定します。これでアプリケーションはVonage APIで使用する準備が整いました。
プロジェクト用の新しいディレクトリを作成し、新しいNodeプロジェクトを初期化し、依存関係をインストールします。
mkdir blog-verify_rcs-node-auth-workflows
cd blog-verify_rcs-node-auth-workflows
npm init -y
npm install @vonage/server-sdk @vonage/verify2
.envファイルを作成します。 環境変数を追加します。それぞれの環境変数が何に使われ、どこにあるのかを説明する。
VERIFY_BRAND_NAME:認証時にユーザーに表示される名前。VONAGE_APPLICATION_PRIVATE_KEY_PATH:秘密鍵ファイルへのパス。VONAGE_APPLICATION_ID:あなたのVonageアプリケーションID。VERIFY_NUMBER:RCS/SMS受信用のテスト用電話番号。RCS_SENDER_ID:外部アカウントのリンク」タブにあるRCSの送信者ID。
JavaScriptファイルを作成する。 index.jsを作成し、依存関係を初期化する：
// index.js
require("dotenv").config();
const { Vonage } = require("@vonage/server-sdk");
const { Channels } = require("@vonage/verify2");
const vonage = new Vonage({
applicationId: process.env.VONAGE_APPLICATION_ID,
privateKey: process.env.VONAGE_APPLICATION_PRIVATE_KEY_PATH,
});の vonage.verify2.newRequest を使用します。 を使います。を使用し、それぞれRCS（最初の試行）とSMS（フォールバック）チャネルを追加します。
// index.js
vonage.verify2
.newRequest({
brand: process.env.VERIFY_BRAND_NAME,
workflow: [
{
channel: Channels.RCS,
to: process.env.VERIFY_NUMBER,
from: process.env.RCS_SENDER_ID,
},
{
channel: Channels.SMS,
to: process.env.VERIFY_NUMBER,
},
],
})
.then(({ requestId }) => console.log(requestId))
.catch((err) => console.error(err));
コマンドnodeの後にJavaScriptファイル名を続けて実行する。そうすると、環境変数に指定した番号にメッセージが送信されます。 VERIFY_NUMBER.それが不可能な場合は、代替手段としてSMSメッセージが送信されます。
node index.js注意：リクエストがブロックされたことを示すコールバックをウェブフックに受信した場合、ターゲットネットワークはプラットフォームの不正防止システムによってブロックされている可能性があります。 不正防止システム.
ユーザが不正行為を軽減できるよう支援できれば、それに越したことはありません。Vonage Verify APIは、様々なチャネルにワンタイムパスワード（OTP）を送信することで、ユーザーを検証することができます。今日紹介するコードは フォールバックのために複数のチャンネルを使用して検証リクエストを送信する方法しかし、このチュートリアルはJavaScriptのRCSとSMSチャンネルに焦点を当てています。他の言語での例は、ドキュメントにリンクされています。
以上だ！このブログポストでは、Verify API内でRCSチャンネルを使用する方法と、RCSがデバイス上で利用できない場合に次の指定チャンネルにフォールバックする方法について見てきました。
ご質問がある場合、またはあなたが作っているものを共有したい場合は、こちらをクリックしてください。
登録する 開発者ニュースレター
フォローする X（旧ツイッター）最新情報
チュートリアルを見る YouTubeチャンネル
LinkedInの LinkedIn の Vonage デベロッパーページ
最新の開発者向けニュース、ヒント、イベント情報をお届けします。