英語からAIを使用して翻訳されました
この記事はAI技術を使用して翻訳されたことにご注意ください。正確性を維持するよう努めていますが、一部の詳細は元のテキストを完全に反映していない場合があります。情報に不明な点がある場合は、英語版を参照してください。
OAuth認証情報は、Contentsquareの公開API（Metrics APIおよびRaw Data API）を認証するために使用されます。また、iOSおよびAndroidのモバイルクラッシュレポートにも使用されます。
これらの認証情報は、特定の認証エンドポイントに提供する必要がある一対のclient_idとclient_secretで構成されています。
認証エンドポイントは、2つの重要な要素を返します：
- Contentsquareの指標および生データエンドポイントをクエリするために使用される有効なJWTトークン
- すべてのContentsquare APIエンドポイントのためのベースURLで、動的であり、あなたのユニークなクラウドホスティング（AWS対Azureおよび地域）に依存します
認証情報は、2つのレベルのいずれかで生成できます：
- アカウントレベルでは、認証情報が生成されたアカウントに関連付けられた任意のプロジェクトのリソースを要求できます。
- プロジェクトレベルでは、認証情報が生成された特定のプロジェクトのリソースのみを要求できます。
APIキーは非推奨になりました
Contentsquareは2023年にAPIキーを非推奨にしました。APIキーはAPIにアクセスするために使用される静的な認証情報でした。2024年4月30日以降、APIキーを使用しているアプリケーションは動作を停止します。これには以下が含まれます：
- 生データおよび指標API
- Looker Studioコネクタ
- Qualtrics拡張（埋め込まれたセッションリプレイプレーヤー）
- J+Report（Reeport）
- Dexem
継続的なアクセスを確保するためには、OAuth認証情報に移行する必要があります。OAuthは、client_idおよびclient_secretに関連付けられた短命のアクセストークンを発行することにより、より強力なセキュリティを提供し、より良い制御とユーザー認証を可能にします。
既存のAPIキーを置き換えるための移行手順に従ってください。
モバイルクラッシュレポートのためのAPI認証情報の使用
API認証情報は、iOSおよびAndroidのクラッシュレポートの両方に使用されます。
iOSクラッシュレポート
API認証情報を使用して、エラー分析のためにdSYMファイルをアップロードし、読みやすいクラッシュレポートを確保します。以下の手順に従ってClient IDとClient Secretを取得した後、私たちのdSYMsのアップロードに関する技術文書を参照してください。
Androidクラッシュレポート
Gradleクラッシュプラグインのために、build.gradleファイル内でAPI認証情報が必要です。これにより、マッピングファイルのアップロードとクラッシュレポートのシンボリケートが自動化されます。以下の手順に従って認証情報を作成し、その後、私たちのクラッシュレポータに関する技術文書を参照してください。
認証情報の作成方法
1. 'コンソール'に移動します
2. アカウントまたはプロジェクトレベルを選択し、'API認証情報'タブに移動し、次に'アカウント認証情報を作成'をクリックします。
- アカウントのすべてのプロジェクトにアクセスできる認証情報が必要な場合はアカウントレベルを、特定のプロジェクトのみにアクセスできる認証情報が必要な場合はプロジェクトレベルを選択します。
- アカウントレベルとプロジェクトレベルの両方で、同じ'API認証情報'タブが見つかります。
- プロジェクトレベルの場合： プロジェクトに移動 > 'API認証情報'タブ > 'アカウント認証情報を作成'
- アカウントレベルの場合： アカウントに移動 > 'API認証情報'タブ > 'アカウント認証情報を作成'
- すでに認証情報が作成されている場合、'アカウント認証情報を作成'ボタンは認証情報リストの右上隅にあります。
3. OAuth認証情報の情報を入力します：認証情報の名前とそれを使用できるIPのリスト（デフォルトでは任意のIP）を入力し、'アカウント/プロジェクト認証情報を作成'をクリックします。
- 特定のIPのホワイトリストを提供する必要がある場合は、'特定のIPアドレスを許可'を選択し、ホワイトリストに追加したいすべてのIPをリストアップし（IPv4またはIPv6形式）、次に'アカウント/プロジェクト認証情報を作成'をクリックします。
4. 生成されたOAuth認証情報が表示されるポップアップが表示されます。認証情報を安全な場所に保管してください。これが表示される最後の機会であり、Contentsquareはセキュリティ上の理由からそれらを保存しません。'認証情報をコピーしました'をクリックします。
5. 新しい認証情報がリストされるAPI認証情報タブビューにリダイレクトされます。これで、これらの認証情報を使用してContentsquareの公開APIをクエリできます。
OAuth認証情報を再生成する方法
1. 'コンソール' > 'API認証情報'タブ > '...' その他のオプションメニュー > '認証情報を再生成'に移動します。
2. 確認メッセージのプロンプトを読み、'認証情報を再生成'をクリックします。
3. 新しい認証情報がポップアップに表示されます。これを使用して、使用中の既存の認証情報を更新します。再生成された認証情報は、その接続の以前の認証情報を無効にします。
- クライアントシークレットをコピーして保存してください。再度表示したり、後で回復したりすることはできません。 '資格情報をコピーしました'をクリックします。
OAuth資格情報の編集方法
1. 'コンソール' > 'API資格情報'タブ > '...' その他のオプションメニュー > '資格情報を編集'に移動します。
2. 資格情報の構成フォームが開きます。名前、説明、ホワイトリストに登録されたIPのリストを編集し、'アカウント資格情報を編集'をクリックして保存します。
資格情報を取り消す方法
1. 'コンソール' > 'API資格情報'タブ > '...' その他のオプションメニュー > '資格情報を取り消す'に移動します。
2. 資格情報を取り消すとアプリケーションが中断される可能性があることを思い出させるポップイン確認メッセージを読みます。'資格情報を取り消す'をクリックします。
3. あなたの資格情報は資格情報のリストから削除され、Contentsquareの公開APIをクエリするために使用できなくなります。