개요 — 무엇을 하나
Administration ▸ API Keys 는 외부 앱·호스트가 InfraGuard 로 데이터를 PUSH 하도록 API 키를 발급합니다. 발급 화면은 두 트랙의 연동 코드를 보여줍니다.
- 트랙 A · 인시던트 리포터 (Laravel + Pulse) — 외부 Laravel 앱의 PHP 오류를
POST /api/v1/incidents로 전송 → Service ▸ 문제 해결 보드에 자동 등재. - 트랙 B · 보안 진단 스캔 리포터 (호스트 크론) — 각 호스트가
infr_seccheck_probe.cjs --min을 크론으로 돌려POST /api/v1/security/scan전송 → 보안 진단.
화면 구성 · 사용법
- [키 발급] — 이름만 입력. 평문 키는 1회만 노출(issued 모달). DB 엔
key_hash(해시)만 저장, 목록은 마스킹. - 발급된 키를 대상 프로젝트/호스트
.env또는 리포터 스크립트에 넣습니다. - 화면의 연동 코드(env/config/reporter/bootstrap + curl · 셸 리포터 + crontab)를 복사해 배포합니다.
curl -s {URL}/api/v1/ping -H "Authorization: Bearer igk_..."
스코프는
incident.write·scan.write. 연동 코드의 정본 스니펫은resources/stubs/infraguard/*.stub이며 주석이 세션 로케일로 번역됩니다.
데이터 소스
infr_api_key(key_hash + secret_enc 복구용 · scopes) ·App\Support\ReporterSnippet
권한
level≥10(관리자) + 감사(발급·토글·폐기).
관련 항목
