New Relic APIキー

ライセンスキーは、ほぼすべてのデータを報告するために使用されます（独自のキーを使用するブラウザとモバイル監視のデータを除く）。各キーは特定のアカウントに関連付けられており、ユーザーは好きなだけキーを作成できます。ライセンスキーは更新できないため、削除して新しいキーを作成して置き換える必要があります。

アカウントのライセンスキーは、one.newrelic.com/api-keys（EUデータセンターの場合はone.eu.newrelic.com/api-keys）にあるAPIキーUIで見つけることができます。すべての製品管理者権限またはそれらのキーを表示できるカスタムロールを持っていない限り、使用権限があるキーのみが表示されます。

デフォルトでは、すべてのNew Relicアカウントは、オリジナルのアカウントライセンスキーを使用して作成され、組織全体で共有されます。このキーをAPIキーUIから削除することはできませんが、 New Relicサポートに連絡してキーをローテーションすることはできます。

ユーザーが作成したライセンスキーをローテーションするには：

1. キーをローテーションするNew Relicユーザーとしてログインします。

2. one.newrelic.com/api-keys（またはEUデータセンターの場合はone.eu.newrelic.com/api-keys）に移動します。

3. API keysページの右上隅にあるCreate a keyをクリックします。

   

4. 新しいキー名を入力し、Key typeにIngest - Licenseを選択し、オプションの説明を追加して、 Saveをクリックします。

   

5. 古いキーを参照するスクリプトまたはコードを新しいキーの値で更新します。新しいキーを見つけるには、新しいキーと同じ行にある...アイコンをクリックし、次にCopy keyをクリックします。

   

6. 外部依存関係が更新されたら、古いキーと同じ行にある...アイコンをクリックし、次にDeleteをクリックすると、古いキーを安全に削除できます。

   

7. キーが正常に削除されると、右下隅に次のメッセージが表示されます。

   

   NerdGraph APIを介してライセンスキーを管理することもできます。手順については、NerdGraphチュートリアル：APIキーの管理を参照してください。

ブラウザキーはブラウザ監視データを報告するために使用されます。各キーは特定のアカウントに関連付けられており、顧客は好きなだけキーを作成できます。

アカウントのブラウザキーは、one.newrelic.com/api-keys（EUデータセンターの場合はone.eu.newrelic.com/api-keys）にあるAPIキーUIで見つけることができます。すべての製品管理者権限またはそれらのキーを表示できるカスタムロールを持っていない限り、使用権限があるキーのみが表示されます。

デフォルトでは、すべてのNew Relicアカウントは、オリジナルのアカウントライセンスキーを使用して作成され、組織全体で共有されます。このキーをAPIキーUIから削除することはできませんが、 New Relicサポートに連絡してキーをローテーションすることはできます。

ユーザーが作成したブラウザキーをローテーションするには：

1. キーをローテーションするNew Relicユーザーとしてログインします。

2. one.newrelic.com/api-keys（またはEUデータセンターの場合はone.eu.newrelic.com/api-keys）に移動します。

3. API keysページの右上隅にあるCreate a keyをクリックします。

   

4. 新しいキー名を入力し、Key typeにIngest - Browserを選択し、オプションの説明を追加して、 Saveをクリックします。

   

5. 古いキーを参照するスクリプトまたはコードを新しいキーの値で更新します。新しいキーを見つけるには、新しいキーと同じ行にある...アイコンをクリックし、次にCopy keyをクリックします。

   

6. 外部依存関係が更新されたら、古いキーと同じ行にある...アイコンをクリックし、次にDeleteをクリックすると、古いキーを安全に削除できます。

   

7. キーが正常に削除されると、右下隅に次のメッセージが表示されます。

   

モバイル監視は、ライセンスキーではなく、モバイルアプリを使用してデータを報告します。モバイルアプリトークンはすべて一意であり、アプリケーションがNR1に登録されるたびに再生成されます。アプリに関連付けられているモバイルキーをローテーションするには、New Relicでアプリを再認証します。

アプリトークンの詳細については、モバイル監視の設定を参照してください。

New Relicユーザーキー（「パーソナルAPIキー」とも呼ばれます）は、NerdGraphとREST APIを使用するために必要です。キーは組織または特定のユーザーに属することができます。

アカウントのユーザーキーは、one.newrelic.com/api-keys（EUデータセンターの場合はone.eu.newrelic.com/api-keys）にあるAPIキーUIで見つけることができます。すべての製品管理者権限またはそれらのキーを表示できるカスタムロールを持っていない限り、使用権限があるキーのみが表示されます。

ユーザーキーをローテーションするには、新しいキーを作成し、ソフトウェア内の古いキーへの参照を更新してから、古いキーを削除します。UIでキーをローテーションするには：

1. キーをローテーションするNew Relicユーザーとしてログインします。

2. one.newrelic.com/api-keys（またはEUデータセンターの場合はone.eu.newrelic.com/api-keys）に移動します。

3. API keysページの右上隅にあるCreate a keyをクリックします。

   

4. 新しいキー名を入力し、Key typeにUserを選択し、オプションの説明を追加して、 Saveをクリックします。

   

5. 古いキーを参照するスクリプトまたはコードを新しいキーの値で更新します。新しいキーを見つけるには、新しいキーと同じ行にある...アイコンをクリックし、次にCopy keyをクリックします。

   

6. 外部依存関係が更新されたら、古いキーと同じ行にある...アイコンをクリックし、次にDeleteをクリックすると、古いキーを安全に削除できます。

   

7. キーが正常に削除されると、右下隅に次のメッセージが表示されます。

   

   NerdGraph API経由でユーザーキーを管理することもできます。手順については、NerdGraphチュートリアル：APIキーの管理を参照してください。

これらは、顧客による使用は推奨されていない古いキーですが、New Relicでは引き続きサポートされています。これらのキーは、メトリクス、イベント、ログ、トレースAPI経由でデータを取り込むために使用され、組織全体に適用されます。

これらのキーをローテーションするには：

1. 管理者権限を持つアカウントでNew Relicにログインします。

2. one.newrelic.com/api-keys（またはEUデータセンターの場合はone.eu.newrelic.com/api-keys）に移動します。

3. ページの右側にあるLooking for other keys?セクションを見つけて、ローテーションするキーの種類のリンクをクリックします。

   

4. 新しい挿入キーまたはクエリキーを作成するには、 +アイコンをクリックします。

   

5. 古いキーを参照するスクリプトまたはコードを新しいキーの値で更新します。

6. 外部依存関係が更新されたら、古いキーを安全に削除できます。キーを削除するには、キーの上にマウスを移動してDeleteをクリックします。

   

Pixie APIキーは、カスタムアプリケーションをPixieプラットフォームに対して認証するために使用されます。Pixie APIキーは変更できません。Pixie APIキーをローテーションするには、新しいキーを作成してから古いキーを削除する必要があります。Pixie APIキーの詳細については、PixieドキュメントのAPIキーの管理を参照してください。

パートナーシップAPIは、New Relicの担当者から使用を明示的に指示されない限り、組織では使用できません。APIの詳細については、パートナーシップAPIリファレンスを参照してください。

キーを表示または再生成するには、パートナーシップ所有者の認証情報を使用してNew Relicにログインし、 Partnerships > Edit settingsに移動します。

データの取り込みに使用される主なキーはライセンスキーと呼ばれます。APIキーUIおよびNerdGraphでは、このキーは ingest - licenseとして参照されることがあります。

ライセンスキーは、ほぼすべてのNew Relicデータの取り込みに必要です。例外は、ブラウザ監視データ（ブラウザキーを使用）とモバイル監視データ（モバイルアプリを使用）です。

ライセンスキーは、New Relicアカウントに関連付けられた40文字16進数の文字列です。初めてNew Relicにサインアップすると、単一のアカウントと独自のライセンスキーを含む組織が作成されます。さらにアカウントを追加すると、各アカウントには独自のライセンスキーが含まれます。アカウント用に最初に作成されたライセンスキーは削除できませんが、管理および削除できる追加のライセンスキーを作成することはできます。これは、キーのローテーションなどのセキュリティ慣行を実装するのに役立ちます。アカウントの元のアカウントのライセンスキーをローテーションする必要がある場合は、サポートにお問い合わせください。

ユーザーがライセンスキーを表示または管理できないようにするには、これらの権限を持たないロールをユーザーに割り当てます。新しいユーザーモデル。

ブラウザ監視は、ライセンスキーではなくブラウザキーを使用してデータを報告します。ブラウザキーは、ブラウザ監視エージェントからのデータをアカウントに関連付けるために使用されます。

アカウントの作成時に作成された元のブラウザキーを管理または削除することはできませんが、新しいブラウザキーを作成してそれらのキーを削除することはできます。アカウントの元のブラウザキーのローテーションに関するサポートが必要な場合は、サポートにお問い合わせください。

モバイル監視は、ライセンスキーではなく、モバイルアプリを使用してデータを報告します。詳細については、モバイルアプリトークンを参照してください。

New Relicユーザーキー（「パーソナルAPIキー」とも呼ばれます）は、NerdGraphとREST APIを使用するために必要です。

ユーザーキーは、特定のNew Relicユーザーに関連付けられており、転送できません。ユーザーキーを使用すると、キーが関連付けられている特定のアカウントだけでなく、アクセスが許可されているすべてのアカウントに対してクエリを実行できます。New RelicユーザーがNew Relicで削除されると、そのユーザーキーも非アクティブ化され、機能しなくなります。

ユーザーに複数のアカウントへのアクセスを提供するにもかかわらず、ユーザーキーは、その作成元のアカウントである1つの特定のアカウントにリンクされています。重要なのは、アカウントが削除されると、そのアカウントに関連付けられているユーザーキーはすべて機能しなくなるということです。（また、当社のREST APIでは、呼び出しはそのユーザーキーに関連付けられたアカウントに限定されます。）

ユーザーがユーザーキーを表示または管理できないようにするには、これらの権限を持たないロール（元のユーザーモデル | 新しいユーザーモデル)をユーザーに割り当てます。