メインコンテンツへスキップ
以下の Auth0 Log Extensions は現在非推奨であり、下記のサポート終了 (EOL) 日までサポートされます。この非推奨の Log Extensions の一覧に含まれる拡張機能は、新規作成できなくなっています。同等の機能は、ログイベントストリームまたは Auth0 Marketplace の統合を使用して設定できます。 以下は、Private Cloud で 2023 年 1 月 6 日 に EOL を迎えます。
  • Auth0 Authentication API Webhooks
  • Auth0 Webhooks
  • Logs to Cloudwatch
  • Logs to Logentries
  • Logs to Loggly
  • Logs to Logstash
  • Logs to Papertrail
  • Logs to Splunk
  • Logs to Sumo Logic
以下は、Public Cloud で 2023 年 5 月 2 日 に EOL を迎えます。
  • Auth0 Authentication API Webhooks
  • Auth0 Management API Webhooks
  • Logs to Cloudwatch
  • Logs to Logentries
  • Logs to Loggly
  • Logs to Logstash
  • Logs to Papertrail
  • Logs to Splunk
  • Logs to Sumo Logic
  • Logs to Segment
  • Logs to Mixpanel
  • Logs to AppInsights
  • Logs to Azure Blob Storage
記載された EOL 日以降、Auth0 は上記一覧にあるインストール済みの log extensions をサポートしなくなります。このページでは、特定の log extensions から移行するための手順を確認できます。

​
Auth0 Authentication API Webhooks

送信先で log オブジェクトの配列を処理できることを確認してください。
  1. Auth0 Dashboard にログインします。
  2. Extensions に移動し、Installed Extensions タブで Auth0 Authentication API webhook を選択します。
  3. Webhook URL と Authorization Header (存在する場合) をコピーします。
  4. 次に、Monitoring > Streams > New Event Stream に移動します。
  5. Custom Webhook を選択し、名前を入力して Create をクリックします。
  6. webhook を設定します。
    • Payload URL に、拡張機能からコピーした webhook URL を入力します。
    • 存在する場合は、Authorization Token に拡張機能からコピーした Authorization Header を設定します。
    • Content Format を JSON Array に設定します。
  7. Save をクリックします。
  8. Extensions > Installed Extensions に戻り、Auth0 Authentication API webhooks 拡張機能を無効にします。

​
Auth0 Management API Webhooks

送信先でログオブジェクトの配列を処理できることを確認してください。
  1. Auth0 Dashboard にログインします。
  2. Extensions に移動し、Installed Extensions タブで Auth0 Management API webhook を選択します。
  3. Webhook URL と Authorization Header (ある場合) をコピーします。
  4. Monitoring > Streams > New Event Stream に移動します。
  5. Custom Webhook を選択し、名前を入力して Create をクリックします。
  6. Webhook を設定します。
    • Payload URL に、拡張機能からコピーした Webhook URL を入力します。
    • ある場合は、Authorization Token に拡張機能からコピーした Authorization Header を設定します。
    • Content Format を JSON Array に設定します。
  7. Save をクリックします。
  8. Extensions > Installed Extensions に戻り、Auth0 Management API webhooks 拡張機能を無効にします。

​
CloudWatch

Auth0 Marketplace で利用できる Amazon EventBridge 統合 を設定します。イベントがイベントバスで利用可能になったら、ルールを作成 して、それらのイベントを AWS CloudWatch にマッピングします。Auth0 Logs to CloudWatch 拡張機能は必ず無効にしてください。
  1. Auth0 Dashboard にログイン します。
  2. Extensions > Installed Extensions に移動します。
  3. Auth0 Logs to CloudWatch 拡張機能を無効にします。

​
Loggly

  1. Loggly アカウントにログインします。
  2. Logs メニューを開き、Source Setup を選択します。
  3. Customer Tokens タブを開きます。
  4. トークンをコピーします。
  5. Auth0 Dashboard にログインします。
  6. Monitoring > Streams > New Event Stream に移動します。
  7. Custom Webhookを選択し、名前を入力して Create をクリックします。
  8. Webhook を設定します。
    • Payload URL では、LOGGLY_TOKEN を Loggly アカウントからコピーしたトークンに置き換えます。https://logs-01.loggly.com/bulk/{LOGGLY_TOKEN}/tag/auth0-{TENANT_NAME}/
    • Authorization Token は空欄のままにします。
    • Content Type を application/json に設定します。
    • Content Format を JSON Lines に設定します。
  9. Save をクリックします。
  10. Extensions > Installed Extensions に移動し、Auth0 Logs to Loggly 拡張機能を無効にします。

​
Logstash

  1. Auth0 Dashboard にログインします。
  2. Monitoring > Streams > New Event Stream に移動します。
  3. Custom Webhook を選択し、名前を入力して Create をクリックします。
  4. Webhook を設定します。
    • Payload URL に、Logstash サーバーの URL を入力します。
    • Authorization Token を Basic <CREDENTIALS> に設定します。CREDENTIALS は、Logstash のユーザー名とパスワードをコロン (<USER:PASSWORD>) で区切って連結した文字列を Base64 エンコードした値に置き換えてください。Logstash の HTTP 認証情報は、Logstash の設定ファイルで確認できます。
  5. Save をクリックします。
  6. Extensions > Installed Extensions に移動し、Auth0 Logs to Logstash 拡張機能を無効にします。

​
Papertrail

  1. Papertrail にログインします。
  2. Log Destinations に移動し、Create Log Destination をクリックします。
  3. 説明を入力し、送信先の設定を行います。
  4. Accept Connections via … ペインで、Token を選択します。
  5. Create をクリックします。
  6. Auth0 Dashboard にログイン します。
  7. Monitoring > Streams > New Event Stream に移動します。
  8. Custom Webhook を選択し、名前を入力して Create をクリックします。
  9. Webhook を設定します。
    • Payload URL を https://logs.collector.solarwinds.com/v1/logs に設定します。
    • Authorization Token を Basic <CREDENTIALS> に設定し、CREDENTIALS は Papertrail の送信先設定で取得した Papertrail トークンを Base64 でエンコードした値に置き換えます。
    • Content Format を JSON Lines に設定します。
  10. Save をクリックします。
  11. Extensions > Installed Extensions に移動し、Auth0 Logs to Papertrail 拡張機能を無効にします。

​
Splunk

Auth0 Marketplace で提供されている Splunk 統合 を使用します。必ず Auth0 Logs to Splunk 拡張機能を無効にしてください。
  1. Auth0 Dashboard にログインします。
  2. Extensions > Installed Extensions に移動します。
  3. Auth0 Logs to Splunk 拡張機能を無効にします。

​
Sumo Logic

Auth0 Marketplace で提供されている Sumo Logic 統合 を使用します。事前に Auth0 Logs to Sumo Logic 拡張機能を無効にしてください。
  1. Auth0 Dashboard にログインします。
  2. Extensions > Installed Extensions に移動します。
  3. Auth0 Logs to Sumo Logic 拡張機能を無効にします。

​
Logentries

現在、Logs to Logentries 拡張機能からログストリームへの移行手順はありません。

​
Segment

  1. Auth0 Dashboard にログインします
  2. Extensions > Installed Extensions で、Segment 拡張機能を見つけます。
  3. Write Key をメモしておきます。これは、Segment への新しいログストリームの作成時に必要になります。
  4. Segment 拡張機能を無効にします。
  5. Segment で最後に受信したログの UTC タイムスタンプをメモしておきます。このタイムスタンプを把握しておくと、Segment 内でログが重複しないようにしながら新しいストリームを作成できます。
  6. Monitoring > Log Streams に移動し、新しい Segment ログストリームを作成します。適切なフィールドに Write Key を入力し、Start From セクションにメモしておいたタイムスタンプを入力します。
  7. ストリームを作成します

​
Mixpanel

  1. Mixpanel アカウントにログインし、Project Settings を開きます。Project ID と Data Residency (リージョン) を控えておきます。
  2. Mixpanel では、イベントのインポートにプロジェクトトークンを使用することは現在推奨されておらず、代わりにサービスアカウントの使用が推奨されています。Project Settings ページで Service Accounts を選択し、admin または owner 権限を持つ新しいサービスアカウントを作成します。認証情報を控えておきます。
  3. Auth0 Dashboard にログインします。
  4. Monitoring > Log Streams で、新しい Mixpanel ストリームを作成します。Project ID、リージョン、サービスアカウントの認証情報を入力して、ストリームを作成します。
  5. 古い拡張機能を忘れずに無効化してください。Extensions > Installed Extensions に移動し、Auth0 Logs to Mixpanel extension を無効にします。

​
AppInsights

  1. Azure EventGrid Log Stream を設定するか、既存の EventGrid ストリームを使用します。
  2. ログイベントの送信先を設定するには、Azure が公開している手順 に従ってください。
  3. Log Streaming では、ログの変換方法が異なる場合があります。詳細については、非推奨の Log Extenstion code を参照してください
ログに対して行われる主な変換には、次のものがあります。
  • appInsight クライアントは上書きされます。
    • カスタム時刻がログの時刻と同じになるよう設定されます
    • OS と OS バージョンがログ情報と同じになるよう設定されます
    • デバイスタイプタグには、ログの発生元がモバイルかどうかの情報が設定されます
    • IP アドレスタグがログ情報と同じになるよう設定されます
    • user id、account id、user agent、auth user id の各タグがログと同じになるよう設定されます
  • レコードはクリーンアップされ、空の場合は次のプロパティが削除されます。
    • ip
    • user_id
    • user_name
    • connection
    • client_name
    • description
  • レコードの isMobile プロパティは、yes または no の文字列を含むように変更されます
  • レコードの details プロパティは文字列に変換されます
  • レコードの details プロパティは 8185 文字に切り詰められます

​
Azure Blob Storage

  1. Azure EventGrid Log Stream を設定するか、既存の EventGrid ストリームを使用します。
  2. Azure が公開している手順 に従って、log イベントの送信先を設定します。
  3. Log Streaming によって、log は異なる形式に変換される場合があります。詳細については、非推奨の Log Extenstion code を参照してください
log に対して行われる主な変換は次のとおりです。
  • レコードの type_code と type は調整されます。type は type_code の human-readable な説明です
  • レコードに user_agent 情報が含まれている場合、os、os_version、device、device_version は調整されます