安全な資格情報を管理する

安全な資格情報を使用すると、パスワード、 APIキー、エンコードされた証明書などの機密情報を保存、保護、集中管理できます。合成モニターはスクリプト実行中にこの情報に安全にアクセスできます。このチュートリアルでは、NerdGraph API を使用して安全な資格情報をプログラムで管理する方法の例を示します。

安全なクレデンシャルを作成する

syntheticsCreateSecureCredentialミューテーションを使用して安全な認証情報を作成できます。この変更により、スクリプト実行中に合成モニターがアクセスできる機密情報を安全に保存できるようになります。

入力

パラメータ	データタイプ	必須ですか?	説明
`accountId`	整数	はい	安全な資格情報が作成される New Relic アカウントのアカウント ID 。
`description`	弦	いいえ	この資格情報の目的を識別するのに役立つ説明。
`key`	弦	はい	New Relicの外形監視の安全な認証情報の一意のキー識別子。
`value`	弦	はい	安全に保存する機密値 (パスワード、 APIキーなど)。

サンプルリクエスト

mutation {
  syntheticsCreateSecureCredential(
    accountId: ACCOUNT_ID
    description: "Your optional description"
    key: "SECURE_CREDENTIAL_NAME"
    value: "SECURE_CREDENTIAL_VALUE"
  ) {
    errors {
      description
      type
    }
  }
}

サンプル回答

成功した応答はエラーに対してnullを返します:

{
  "data": {
    "syntheticsCreateSecureCredential": {
      "errors": null
    }
  }
}

安全な資格情報の作成中に問題が発生した場合、 errors配列には、何が問題であったかを説明するdescriptionとtypeフィールドを持つオブジェクトが含まれます。

安全なクレデンシャルを更新する

syntheticsUpdateSecureCredentialミューテーションを使用して、既存の安全な認証情報を更新できます。これにより、同じキー名を維持しながら、値と説明を変更できます。

入力

パラメータ	データタイプ	必須ですか?	説明
`accountId`	整数	はい	安全な資格情報を含むアカウント ID 。
`description`	弦	いいえ	安全な資格情報の説明を更新しました。
`key`	弦	はい	New Relicの外形監視の安全な認証情報の一意のキー識別子。
`value`	弦	はい	保存する新しい機密値。

サンプルリクエスト

mutation {
  syntheticsUpdateSecureCredential(
    accountId: ACCOUNT_ID
    description: "Updated description for the secure credential."
    key: "SECURE_CREDENTIAL_NAME"
    value: "SECURE_CREDENTIAL_VALUE"
  ) {
    createdAt
    lastUpdate
    errors {
      description
      type
    }
  }
}

サンプル回答

成功した応答では更新されたメタデータが返され、エラーの場合はnull返されます。

{
  "data": {
    "syntheticsUpdateSecureCredential": {
      "createdAt": "2024-01-15T10:30:00Z",
      "lastUpdate": "2024-01-20T14:45:00Z",
      "errors": null
    }
  }
}

安全な資格情報の更新中に問題が発生した場合、 errors配列には、何が問題であったかを説明するdescriptionフィールドとtypeフィールドを持つオブジェクトが含まれます。

安全なクレデンシャルを削除する

syntheticsDeleteSecureCredentialミューテーションを使用して、安全な資格情報を削除できます。削除されると、この資格情報を参照するすべてのモニターは更新されるまで失敗します。

注意

安全な資格情報を削除する前に、アクティブなモニターがその資格情報を使用していないことを確認してください。使用中の資格情報を削除すると、それらのモニターは失敗します。

入力

パラメータ

データタイプ

必須ですか?

説明

accountId

整数

はい

安全な資格情報を含む

アカウント ID

。

key

弦

はい

New Relicの外形監視の安全な認証情報の一意のキー識別子。

サンプルリクエスト

mutation {
  syntheticsDeleteSecureCredential(
    accountId: ACCOUNT_ID
    key: "SECURE_CREDENTIAL_NAME"
  ) {
    errors {
      description
      type
    }
  }
}

サンプル回答

成功した応答はエラーに対してnullを返します:

{
  "data": {
    "syntheticsDeleteSecureCredential": {
      "errors": null
    }
  }
}

安全な資格情報の削除で問題が発生した場合、 errors配列には、何が問題であったかを説明するdescriptionフィールドとtypeフィールドを持つオブジェクトが含まれます。

この機械翻訳は、参考として提供されています。

安全なクレデンシャルを作成する .css-21sua1{background:none;border:none;width:0;padding:0;}

入力

サンプルリクエスト

サンプル回答

安全なクレデンシャルを更新する

入力

サンプルリクエスト

サンプル回答

安全なクレデンシャルを削除する

注意

入力

サンプルリクエスト

サンプル回答

安全なクレデンシャルを作成する