code またはリンクを取得

パスワードレス接続では、ユーザーがパスワードを覚えておく必要はありません。代わりに、メールまたは SMS で送信されるワンタイム code など、別の方法で本人確認を行います…

POST /passwordless/start

パスワードレス接続では、ユーザーがパスワードを覚えておく必要はありません。代わりに、ユーザーがログインするたびに、メールまたは SMS で送信されるワンタイム code など、別の方法で本人確認を行います。

パスワードレス認証には、次の 3 つの方法があります。

• メールで確認 code を送信する。
• メールでリンクを送信する。
• SMS で確認 code を送信する。

​

備考

• メールアドレスまたは SMS で確認 code を送信した場合は、code を受け取った後、email または phone_number を username として、確認 code を password として使用し、/passwordless/verify エンドポイント を使ってユーザーを認証する必要があります。
• このエンドポイントはクライアント側から呼び出すことを想定して設計されており、[レート制限]https://auth0.com/docs/troubleshoot/customer-support/operational-policies/rate-limit-policy) の対象です。
• auth0.js スクリプトのサンプルでは、ライブラリのバージョン 8 を使用しています。auth0.js バージョン 7 を使用している場合は、このリファレンスガイドを参照してください。

​

エラーコード

このエンドポイントの完全なエラーコードの一覧については、Errors > POST /passwordless/startを参照してください。

​

詳しくはこちら

• パスワードレス認証
• パスワードレスのベストプラクティス

​

パラメーター

client_id · string · 必須

アプリケーションの client_id です。

client_assertion · string

アプリケーションの認証情報を含む、署名付きアサーションの JWT です。アプリケーションの認証方式が Private Key JWT の場合に必須です。

client_assertion_type · string

値 urn:ietf:params:oauth:client-assertion-type:jwt-bearer を使用します。アプリケーションの認証方式が Private Key JWT の場合に必須です。

client_secret · string

アプリケーションの client_secret です。Regular Web Applications でのみ必須です。

connection · string · 必須

ユーザーに確認 code またはリンクを送信する方法です。メールで送信するには email、SMS で送信するには sms を使用します。

使用可能な値: email, sms

email · string

connection=email の場合は、ユーザーのメールアドレスを設定します。

phone_number · string

connection=sms の場合は、ユーザーの電話番号を設定します。

send · string

リンクを送信するには link、確認 code を送信するには code を使用します。null の場合はリンクが送信されます。

使用可能な値: link, code

authParams · object

scope、state、redirect_uri など、追加する認証パラメーターを指定します。

表示 properties

scope · string

OAuth スコープ。

state · string

リクエストとコールバックの間で状態を維持するための state パラメーターです。

​

レスポンス

Status	Description
200	code またはリンクが正常に送信されました。
400	不正なリクエストです。パラメーターが無効です。
401	認証されていません。クライアント認証情報が無効です。