한 장의 그림으로 이해하기

그림 크게 보기 ↗ (새 탭)
안전·권리 · 판정 관망
그림을 글로 풀면
호출과 비밀값 전달 구분
재사용 워크플로를 호출해도 필요한 비밀값이 자동으로 전달되지는 않습니다.
- 대상
- GitHub Actions로 AI 평가를 운영하는 개발자
- 무엇이 바뀜
- 호출하는 작업의 secrets 설정과 받는 쪽의 선언을 함께 확인합니다.
- 왜 중요한가
- 작업 파일만 분리하면 API 키를 받지 못해 호출이 실패할 수 있습니다.
- 지금 할 일
- 필요한 이름만 매핑하고 중첩 호출마다 전달 범위를 대조합니다.
- 한계·미확인
- 개념 비유. 실제 비밀값·워크플로 실행 시험 없음.
- 공식 출처
- docs.github.com
- 확인일
- 2026-10-06
작업 요청이 도착해도 열쇠는 남을 수 있다
여러 저장소에서 쓰는 AI 평가 절차를 재사용 워크플로로 묶는 가상의 상황입니다. 호출 관계가 연결됐다는 사실만으로 모델 API 키까지 전달됐다고 판단하면 원인을 잘못 찾을 수 있습니다. 그림에서 요청서는 도착했지만 손이 빈 상태는 호출과 비밀값 전달이 별개라는 뜻입니다. AINOW는 키 값을 출력하는 대신 호출부의 이름 연결과 받는 쪽 설정부터 대조하도록 제안합니다.
필요한 비밀값의 이름을 연결한다
GitHub 문서에 따르면 호출하는 작업의 secrets에서 이름별 비밀값을 직접 호출 대상에 전달할 수 있습니다. 받는 재사용 워크플로의 workflow_call.secrets 선언도 함께 확인합니다. 같은 조직이나 기업 안의 호출에는 secrets: inherit 방식도 있지만 전달 범위가 넓어질 수 있습니다. AINOW는 필요한 이름을 개별 지정하고 접근 범위를 검토하는 방식을 우선 고려하도록 제안합니다. 전달 설정이 키의 유효성이나 외부 API 권한까지 검증해 주지는 않습니다.
한 단계 더 부르면 그 연결도 확인한다
재사용 워크플로가 또 다른 워크플로를 부르는 경우 비밀값은 직접 호출 관계를 따라 전달됩니다. 첫 번째 연결에서 전달했다는 이유로 마지막 작업까지 받았다고 보지 않습니다. 또한 환경 비밀값은 workflow_call로 환경을 전달하는 방식과 같지 않으며, 호출된 작업에 environment를 지정하면 그 환경의 비밀값이 사용될 수 있습니다. 이번에는 실제 키를 생성·전달하거나 워크플로를 실행하지 않았습니다. 설정 변경은 저장소의 접근 정책과 함께 검토해야 합니다.
참고 원문: GitHub Actions 공식 문서 — 재사용 워크플로의 secrets 전달과 중첩 호출 · 원문 게시일 상시 문서(확인일 기준) · 확인일 2026-10-06
AI 작성·자동 검증: 공식 자료와의 대조 및 게시 구조 검사. 사람의 개별 검수와 제품 실행 시험은 수행하지 않았습니다. 그림은 신규 생성한 개념 일러스트입니다.
이 글의 검증 카드
- 자료 버전
- GitHub Actions 상시 문서2026-10-06 확인. 명시적 secrets 매핑, 동일 조직·기업 inherit, 직접 호출 단계 및 environment 예외. 실제 워크플로·키 전달 시험 없음
- 확인일
- 2026-10-06
- 검증 상태
- 개발자 주장
- 한계·주의
- 개념 비유. 실제 비밀값·워크플로 실행 시험 없음.
함께 더 정확하게
질문·오류 제보
그림에서 이해되지 않는 부분이나 달라진 내용을 알려 주세요. 관리자가 확인하고 승인한 글만 공개됩니다.
개발에서는 이메일 인증 가입 또는 관리자 발급 계정으로 참여할 수 있습니다. 계정·이용 문의
아직 계정이 없으신가요? 회원가입
공개된 질문·제보
아직 공개된 질문·제보가 없습니다. 궁금한 부분을 먼저 남겨 주세요.