Skip to main content

​
Arnica 정보

Iru는 Arnica 웹 플랫폼의 관리자 → API에서 생성한 Bearer API 키를 사용하여 Arnica의 REST API에서 탐지 결과, 리포지토리 인벤토리, 보안 정책 및 개발자 위험 데이터를 읽습니다. 키는 생성 시 범위가 고정됩니다. 통제 항목에 필요한 읽기 범위만 부여하고 쓰기 범위는 절대 부여하지 마세요.

​
작동 방식

Arnica의 API는 버전 v1으로 https://api.app.arnica.io에서 제공됩니다. 키는 Arnica 대시보드에서 범위별로 생성되므로, 범위가 누락된 키는 부분 결과 대신 오류를 반환합니다. Arnica는 모든 인증 및 권한 부여 실패에 대해 401이 아닌 403 상태 코드을 반환합니다. 잘못된 키, 취소된 키, 필수 범위가 누락된 키는 모두 동일하게 보입니다. Iru는 API 키만 저장하며, 구성할 호스트나 하위 도메인은 없습니다. 공식 참고 자료: Arnica 문서, API 레퍼런스(Swagger).

​
사전 요구 사항

  • Arnica 관리자 액세스. 관리자만 관리자 → API를 열어 키를 생성할 수 있습니다.
  • 어떤 리포지토리를 범위에 포함할지 결정하세요. Arnica에서는 리포지토리를 제외할 수 있으며, 제외된 리포지토리는 증거를 생성하지 않습니다. Iru는 리포지토리에 탐지 결과가 없는 것인지, 아니면 스캔된 적이 없는 것인지 구분할 수 없습니다.

​
Arnica를 Iru에 연결

Compliance에서 소스를 연결하기 전에 이 탭을 완료하세요.
1

Arnica에 로그인

admin 역할이 있는 계정으로 https://app.arnica.io에서 Arnica에 로그인합니다.
2

Admin API 열기

관리자 → API로 이동합니다.
3

새 API 키 생성

Create a New API Key를 선택합니다.
4

키 이름 지정

나중에 이 키를 식별할 수 있도록 Iru Compliance와 같은 이름을 입력합니다.
5

읽기 전용 범위 선택

규정 준수 프로그램에 해당하는 읽기 전용 범위를 선택합니다: risks:read, products:read, inventory:read, policies:read, status-checks:read. 통제 항목에 개발자 그룹 멤버십이 포함된 경우 groups:read를 추가합니다. risks:write 또는 기타 쓰기 범위는 부여하지 마세요.
6

토큰 생성 및 복사

만들기를 선택한 다음, Arnica에 토큰 값이 표시될 때 한 번만 복사합니다. Iru에 Bearer 토큰으로 붙여 넣을 때까지 안전하게 보관하세요.
Iru Compliance 탭에서 계속 진행하세요.

​
문제 해결

Iru 사이트의 팝업 차단 설정을 확인한 후 다시 시도하세요.
Arnica는 인증 실패 시 401 대신 403을 반환하므로, 이 오류는 잘못되었거나 만료되었거나 취소된 키뿐만 아니라 범위 누락도 포함합니다. 키를 다시 생성하고, 전체 문자열을 붙여 넣었는지 확인한 다음, 범위 목록을 다시 확인하세요.
키에 risks:read 또는 inventory:read가 없거나, 해당 리포지토리가 Arnica에서 제외되어 있습니다. 제외된 리포지토리는 Iru에 표시되지 않습니다.
Arnica는 요청 시가 아닌 일정에 따라 폴링됩니다. 조사하기 전에 전체 수집 주기가 완료될 때까지 기다리세요.

​
관련 문서

Sources 관리

모든 Compliance 소스를 찾아보고 관리합니다.

Compliance 시작하기

프레임워크, 작업 및 아티팩트.

Iru 개요

Endpoint, Compliance 및 Identity가 함께 작동하는 방식.

Artifacts 관리

소스 및 작업에서 수집한 증거를 업로드, 검토 및 정리합니다.