AI 평가를 재사용 워크플로로 옮겼다면 API 키 전달도 따로 확인하기

한 장의 그림으로 이해하기

개념 비유다. 왼쪽에서는 작업 요청을 받은 사람의 손이 비어 있고 열쇠 묶음은 요청자에게 남아 있다. 오른쪽에서는 요청자가 하나의 열쇠를 골라 건네며 나머지 열쇠는 자기 책상 안에 둔다. 요청자는 호출하는 워크플로, 받는 사람은 재사용 워크플로, 선택한 열쇠는 전달하기로 지정한 비밀값을 뜻한다. 재사용 작업을 호출하는 것과 필요한 비밀값을 전달하는 것은 별도 설정이라는 결론이다. 물리적 열쇠 전달은 실제 GitHub 저장·암호화 방식이 아니며 전달 후 권한이나 API 인증 성공도 입증하지 않는다. inherit와 중첩 호출 및 환경 비밀값의 조건은 본문에서 보완한다. 실제 키나 실험 결과는 없다.
내용의 흐름을 표현한 설명용 그림입니다. 실제 제품 화면이나 실행 결과가 아닙니다.
그림 크게 보기 ↗ (새 탭)

안전·권리 · 판정 관망

그림을 글로 풀면

호출과 비밀값 전달 구분

재사용 워크플로를 호출해도 필요한 비밀값이 자동으로 전달되지는 않습니다.

대상
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
검증 상태
개발자 주장
한계·주의
개념 비유. 실제 비밀값·워크플로 실행 시험 없음.

함께 더 정확하게

질문·오류 제보

그림에서 이해되지 않는 부분이나 달라진 내용을 알려 주세요. 관리자가 확인하고 승인한 글만 공개됩니다.

공개된 질문·제보

    아직 공개된 질문·제보가 없습니다. 궁금한 부분을 먼저 남겨 주세요.