보안 자격 증명을 사용하면 암호, API 키 또는 암호화된 인증서와 같은 중요한 정보를 저장, 보호 및 중앙에서 관리할 수 있습니다. 가상 모니터는 스크립트 실행 중에 이 정보에 안전하게 접근할 수 있습니다. 이 튜토리얼에서는 NerdGraph API를 사용하여 보안 자격 증명을 프로그래밍 방식으로 관리하는 방법에 대한 예제를 제공합니다.
보안 자격 증명 만들기
syntheticsCreateSecureCredential 뮤테이션을 사용하면 안전한 자격 증명을 만들 수 있습니다. 이 변형을 사용하면 스크립트 실행 중에 합성 모니터가 액세스할 수 있는 민감한 정보를 안전하게 저장할 수 있습니다.
입력스피커, 변수
매개변수 | 데이터 형식 | 꼭 필요한가요? | 설명 |
|---|---|---|---|
| 정수 | 네 | 보안 자격 증명이 생성될 뉴렐릭 계정의 . |
| 문자열 | 아니요 | 이 자격증의 목적을 파악하는 데 도움이 되는 설명입니다. |
| 문자열 | 네 | 뉴렐릭의 신세틱스 보안 자격 증명에 대한 고유 키입니다. |
| 문자열 | 네 | 안전하게 저장해야 할 중요한 값(비밀번호, 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 변형을 사용하여 기존 보안 자격 증명을 업데이트할 수 있습니다. 이를 통해 키 이름은 그대로 유지하면서 값과 설명을 수정할 수 있습니다.
입력스피커, 변수
매개변수 | 데이터 형식 | 꼭 필요한가요? | 설명 |
|---|---|---|---|
| 정수 | 네 | 보안 자격 증명이 포함된 입니다. |
| 문자열 | 아니요 | 보안 자격 증명에 대한 설명이 업데이트되었습니다. |
| 문자열 | 네 | 뉴렐릭의 신세틱스 보안 자격 증명에 대한 고유 키입니다. |
| 문자열 | 네 | 새로운 민감 값을 저장합니다. |
샘플 요청
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 뮤테이션을 사용하면 보안 자격 증명을 삭제할 수 있습니다. 삭제되면 해당 자격 증명을 참조하는 모든 모니터링 작업은 업데이트될 때까지 실패합니다.
주의
보안 자격 증명을 삭제하기 전에 해당 자격 증명을 사용하는 활성 모니터링 프로세스가 없는지 확인하십시오. 사용 중인 자격 증명을 삭제하면 해당 모니터링 기능이 작동하지 않게 됩니다.
입력스피커, 변수
매개변수 | 데이터 형식 | 꼭 필요한가요? | 설명 |
|---|---|---|---|
| 정수 | 네 | 보안 자격 증명이 포함된 입니다. |
| 문자열 | 네 | 뉴렐릭의 신세틱스 보안 자격 증명에 대한 고유 키입니다. |
샘플 요청
mutation { syntheticsDeleteSecureCredential( accountId: ACCOUNT_ID key: "SECURE_CREDENTIAL_NAME" ) { errors { description type } }}샘플 응답
성공적인 응답은 오류 발생 시 null 반환합니다.
{ "data": { "syntheticsDeleteSecureCredential": { "errors": null } }}보안 자격 증명을 삭제하는 데 문제가 있는 경우 errors 에는 오류가 발생한 이유를 설명하는 description 및 type 필드가 있는 객체가 포함됩니다.