당사의 모니터링 솔루션과 API는 API 키를 사용하여 귀하의 신원을 인증하고 확인합니다. 이 키를 사용하면 조직에서 승인된 사람만 뉴렐릭에 데이터를 보고하고 해당 데이터에 액세스하고 기능을 구성할 수 있습니다. 기본 키는 볼륨 키(데이터 보고용)와 (GraphQL API 인 NerdGraph 작업용)입니다.
수집 키(계정용): 수집 키를 생성할 때, 전체 키를 임시로 제공해 드립니다. 하지만 API 키가 생성되면 API 키 UI에는 처음 8자만 표시됩니다. API 키 생성 후 전체 키를 조회해야 하는 경우, API 키 UI 에서 점 세 개(…)를 클릭하고 키 ID를 복사한 다음 NerdGraph를 사용하여 전체 키를 조회하세요.
사용자 키(본인 사용 목적): 사용자 키를 생성할 때, 저희는 임시로 전체 키를 제공해 드립니다. 하지만 API 키가 생성되면 API 키 UI에는 처음 8자만 표시됩니다. API 키 생성 후 전체 키를 조회해야 하는 경우, API 키 UI 에서 점 세 개(…)를 클릭하고 키 ID를 복사한 다음 NerdGraph를 사용하여 전체 키를 조회하세요.
다른 사용자를 위한 사용자 키: 다른 사용자를 위한 사용자 키를 생성할 때 API 키 UI 와 NerdGraph에서는 항상 축약된 버전의 키만 표시됩니다.
API 키 관리에 대한 권장사항
API 키가 잘못된 사람의 손에 들어가면 보안 위험이 발생할 수 있습니다. 예를 들어:
귀하의 가진 누군가가 귀하의 계정으로 임의의 데이터를 보낼 수 있습니다.
팀원의 사용자 키 중 하나를 가진 사람이 New Relic 데이터를 보고 New Relic 계정을 변경할 수 있습니다.
비밀번호 및 기타 민감한 정보와 마찬가지로 API 키를 안전하게 취급해야 합니다. 몇 가지 권장 사항:
라이센스 키와 브라우저 키의 경우 키 순환 전략 구현을 고려하십시오. 새 키를 만들고 정해진 일정에 따라 이전 키를 삭제하십시오. 고려 사항:
계정에 연결된 원래 수집 키는 삭제할 수 없으므로 나중에 삭제할 수 있는 추가 수집 키를 만드는 것이 좋습니다. 이를 통해 강력한 보안 태세를 갖추는 것이 가능합니다.
모바일 앱 토큰에는 적용되지 않습니다. 토큰을 삭제하거나 추가 토큰을 만들 수 없습니다.
의 경우:
팀원들에게 사용자 키를 안전하게 유지하도록 지시하십시오.
구성원이 조직을 떠날 때 뉴렐릭에서 해당 사용자 ID를 제거하세요. 이렇게 하면 사용자 ID와 연결된 모든 사용자 키가 비활성화됩니다.
키가 마지막으로 활성화된 시기를 보여줍니다. 키를 교체하거나 삭제하기 전에 오래된 키를 식별하는 데 사용하십시오.
사용자 키만
Last used
열을 참조하십시오.
사용자 키: 시간 제한 없이 영구적으로 저장됩니다.
라이선스 수집 키: 지원되지 않습니다.
브라우저 수집 키: 지원되지 않습니다.
Owning team
키를 순환하거나 비활성화하기 전에 연락할 사람을 항상 알 수 있도록 키에 하나 이상의 팀을 할당합니다.
라이선스 수집 키 전용
키 행 위에 마우스를 올리고
Team
열에서
Edit
을(를) 클릭하고 팀을 선택한 다음
Save
을(를) 클릭하십시오. 특정 팀에 할당된 모든 키를 찾으려면
Team
필터를 사용하십시오. 또한
owningTeamIds
파라미터를 사용하여 NerdGraph를 통해 수집 키를 생성하거나 업데이트할 때 소유 팀을 설정할 수 있습니다.
사용자 키: 사용할 수 없습니다.
라이선스 수집 키: 지원됩니다. 하나의 키에 여러 팀을 지정할 수 있습니다.
브라우저 수집 키: 사용할 수 없습니다.
기본 계정 키: N/A
Deactivate / Reactivate
키를 삭제하지 않고 일시적으로 인증을 방지합니다. 잠재적인 보안 인시던트를 억제하거나 스크림 테스트를 실행하는 데 사용하십시오.
모든 키 유형
비활성화하려면: 키 행에서 ...을(를) 클릭하고 Deactivate key을(를) 선택한 다음 확인합니다.
재활성화하려면 Status > Deactivated(으)로 필터링하고 ...을(를) 클릭한 다음 Activate key을(를) 선택하십시오.
NerdGraph를 통해 키를 관리하려면 키 생성 또는 업데이트 뮤테이션에서 enabled 필드를 사용하십시오. 키를 비활성화하려면 enabled: false을(를) 설정하십시오. 다시 활성화하려면 enabled: true을(를) 설정하십시오. 키의 상태를 변경하지 않고 유지하려면 필드를 생략하십시오.
사용자 키: 지원됩니다.
라이선스 수집 키: 지원됩니다. 다시 활성화할 때까지 데이터 수집을 중지합니다.
브라우저 수집 키: 지원됩니다.
기본 계정 키: 이 키는 비활성화할 수 없습니다.
필수 권한
동작
필수 권한
마지막 사용, 소유 팀 보기
키 읽기 액세스
소유 팀 할당 또는 제거
키 편집 액세스
본인의 키 비활성화 또는 재활성화
추가 권한이 필요하지 않습니다
다른 사용자의 키 비활성화 또는 재활성화
모든 사용자 API 키 관리
API 키를 교체하세요
다음은 가장 일반적인 API 키 4개를 각각 교체하는 방법입니다.
라이선스 키는 거의 모든 데이터를 보고하는 데 사용됩니다. (자체 키를 사용하는 브라우저 및 모바일 모니터링 데이터 제외) 각 키는 특정 계정에 연결되어 있으며 사용자는 원하는 만큼 키를 생성할 수 있습니다. 라이선스 키는 업데이트할 수 없으며 삭제한 후 새 키를 생성하여 교체해야 합니다.
페이지 오른쪽에서 Looking for other keys? 섹션을 찾아 교체하려는 키 유형에 대한 링크를 클릭합니다.
새로운 삽입 또는 쿼리 키를 생성하려면 + 아이콘을 클릭하십시오.
이전 키를 참조하는 모든 파일이나 코드를 새로운 핵심 가치로 업데이트하세요.
외부 의존성/종속성이 업데이트되면 이전 키를 안전하게 삭제할 수 있습니다. 키를 제거하려면 해당 키 위에 마우스를 놓고 Delete 클릭하세요.
Pixie API 키는 사용자 지정 애플리케이션이 Pixie 플랫폼에 인증하는 데 사용됩니다. Pixie API 키는 수정할 수 없습니다. Pixie API 키를 교체하려면 새 키를 생성한 다음 이전 키를 삭제해야 합니다. Pixie API 키에 대한 자세한 내용은 Pixie 문서의 API 키 관리 섹션을 참조하세요.
파트너십 API는 뉴렐릭 담당자가 이를 사용해야 한다고 구체적으로 안내하지 않는 한 조직에서 사용할 수 없습니다. API에 대한 보다 자세한 내용은 파트너십 API 참조를 확인하시기 바랍니다.
키를 보거나 재생성하려면 파트너십 소유자 자격 증명을 사용하여 뉴렐릭에 로그인한 다음 Partnerships > Edit settingss로 이동하세요.
데이터 수집에 사용되는 주요 키를 라이선스 키라고 합니다. API 키 UI 및 NerdGraph 에서 이 키는 때때로 ingest - license 으로 참조됩니다.
거의 모든 New Relic 데이터 수집에는 라이센스 키가 필요합니다. 브라우저 모니터링 데이터(브라우저 키 사용) 및 모바일 모니터링 데이터(모바일 앱 토큰 사용)는 예외입니다.
볼륨 키는 뉴렐릭 계정과 연결된 40자의 16진수 문자열입니다. 뉴렐릭에 처음 가입하면 단일 계정과 자체 라이선스 키를 가진 조직이 생성됩니다. 계정을 추가하면 각 계정은 고유한 라이선스 키로 시작합니다. 계정에 대해 처음 생성된 라이선스 키는 삭제할 수 없지만, 관리 및 삭제가 가능한 추가 라이선스 키를 생성할 수 있으며, 이는 키 순환과 같은 보안 조치를 구현하는 데 유용합니다. 계정의 기존 라이선스 키를 교체해야 하는 경우 고객 지원팀에 문의하십시오.
브라우저 모니터링은 라이센스 키가 아닌 브라우저 키를 사용하여 데이터를 보고합니다. 브라우저 키는 브라우저 모니터링 에이전트 의 데이터를 계정에 연결하는 데 사용됩니다.
계정 생성 시 생성된 원래 브라우저 키는 관리하거나 삭제할 수 없지만, 새 브라우저 키를 생성하고 해당 키를 삭제할 수는 있습니다. 계정의 원래 브라우저 키를 순환하는 데 도움이 필요하면 지원팀에 문의하시기 바랍니다.
모바일 모니터링은 라이선스 키가 아닌 모바일 앱 토큰을 사용하여 데이터를 보고합니다. 자세한 내용은 모바일 앱 토큰 을 참조하세요.
NerdGraph 및 REST API 를 사용하려면 "개인 API 키"라고도 하는 New Relic 사용자 키가 필요합니다.
은(는) 특정 뉴렐릭 사용자와 연결되어 있으므로 양도할 수 없습니다. 사용자 키를 사용하면 키와 연결된 특정 계정뿐만 아니라 액세스 권한이 부여된 모든 계정에 대해 쿼리를 수행할 수 있습니다. 뉴렐릭 사용자가 뉴렐릭에서 삭제되면 해당 사용자 키도 비활성화되어 작동하지 않습니다.
사용자에게 여러 계정에 대한 액세스 권한을 제공하더라도 사용자 키는 단일 특정 계정, 즉 키가 생성된 계정에 연결됩니다. 여기서 중요한 점은 계정이 삭제되면 해당 계정과 연결된 모든 사용자 키가 더 이상 작동하지 않는다는 것입니다. (또한 REST API의 경우 호출은 해당 사용자 키와 연결된 계정으로 제한됩니다.)
이러한 키는 특정 사용자가 아닌 계정과 연결되어 있으므로 키에 대한 액세스 권한이 있는 계정의 모든 사용자가 이를 사용할 수 있습니다.
보안을 위한 모범 사례로 다른 응용 프로그램 또는 다른 데이터 원본에 대해 다른 Insights 삽입 키를 사용하는 것이 좋습니다.
인사이트 삽입 키를 찾고 관리하려면: 사용자 메뉴 에서 API keys ( API 키 페이지로 직접 연결되는 링크 받기)을 클릭하세요. 그런 다음 Insights insert keys) 클릭하세요.
이전 API 키 중 하나는 인사이트 쿼리 API 에 사용되는 인사이트 쿼리 키입니다. 거의 모든 목적에 대해 we recommend using NerdGraph to query and return New Relic data. 한 가지 예외는 이 키가 여전히 Grafana용 Prometheus 데이터 소스로 뉴렐릭을 구성하는 데 사용된다는 것입니다.
인사이트 쿼리 키를 찾고 관리하려면: 사용자 메뉴 에서 API keys ( API 키 페이지로 직접 연결되는 링크 받기)을 클릭하세요. 그런 다음 Insights query keys) 클릭하세요.
관리자 키는 더 이상 사용되지 않는 이전 API 키 중 하나입니다. 2020년 12월 4일부로 기존의 모든 관리 키는 사용자 키로 마이그레이션되었습니다.
관리자 키를 사용하고 있었다면 해당 키를 활성 상태로 유지하기 위해 아무 작업도 수행할 필요가 없습니다. API 키 UI를 통해 자동으로 액세스할 수 있고 사용자 키로 레이블이 지정되며 동일한 권한이 부여됩니다. 동일한 워크플로를 통해 사용자 키처럼 관리할 수 있습니다.
마이그레이션된 모든 관리 키에는 키 테이블에 Migrated from an admin user key 라는 메모가 있습니다.
