Agent는 저장소 분석과 변경 제안에 사용하고, Xcode 빌드·테스트·서명은 독립적으로 검수한 Mac CI 단계에 남겨야 합니다. 이번 주에는 권한, 실행 격리, 출력 승인과 자격 증명 경계를 먼저 확인한 뒤 대표 저장소로 인계 시험을 진행하십시오.
이 글은 GitHub Actions 조직 정책을 관리하는 IT 담당자, iOS 릴리스 파이프라인을 운영하는 엔지니어, CI 보안을 검토하는 보안 담당자를 위한 검수 절차입니다.
마지막 검수: 2026년 11월 11일. GitHub의 공식 공개 안내와 보안 문서, Safe Outputs 문서를 대조했습니다. 실제 조직 정책은 저장소 설정과 시험 실행 기록으로 별도 확인해야 합니다. GitHub는 2026년 10월 28일 GitHub Agentic Workflows의 정식 공개를 발표했습니다. 공식 공개 안내
실행 책임은 Agent 분석과 Mac 빌드로 나눕니다
GitHub Agentic Workflows는 GitHub Actions 안에서 작업하지만, Agent 단계와 Xcode 빌드 단계는 같은 실행 책임으로 취급하면 안 됩니다. 공식 보안 아키텍처에 기재된 Runner 토폴로지는 GitHub 호스팅 또는 Linux 자체 호스팅입니다. 이를 Mac CI 대체 지원으로 해석하지 말고, 문서가 갱신될 때마다 현재 범위를 다시 확인하십시오. 공식 보안 아키텍처의 실행 구조
저장소 분석과 이슈 분류
↓
Agent의 변경 제안
↓
Safe Outputs 검사와 승인
↓
별도 Mac CI로 변경 사항 인계
↓
Xcode 빌드 → 테스트 → 서명 → 배포 승인
저장소 분석은 변경을 직접 반영하지 않는 작업으로 제한합니다. Mac CI는 승인된 커밋이나 검토된 변경만 받아 빌드하고 서명해야 합니다. 파이프라인 문서에 각 단계의 실행 주체와 산출물 위치를 적어 두면, 실패했을 때 어느 경계에서 멈췄는지 추적하기 쉽습니다.
GitHub Agentic Workflows에서 Xcode 빌드와 서명까지 맡겨도 되나요?
현재 공개된 실행 토폴로지만으로 Mac 빌드 지원을 추정해서는 안 됩니다. Xcode가 필요한 빌드와 테스트, 코드 서명은 별도 Mac CI에서 실행하도록 설계하고, 공식 문서의 지원 범위가 바뀌면 그때 다시 검토하십시오. GitHub 호스팅 Runner의 운영체제와 실행 환경 문서
권한 검수는 기본값이 아니라 실제 설정으로 합니다
읽기 전용 기본값만 확인하고 기업 권한 검토를 끝내면 안 됩니다. 워크플로 토큰 권한, 저장소 접근 범위, 실행 이벤트, 조직 정책을 함께 확인해야 합니다. GitHub 문서는 이벤트와 토큰, 비밀값의 동작이 이벤트 종류와 워크플로 설정에 따라 달라질 수 있음을 설명합니다. 워크플로 이벤트와 토큰 권한 문서
기업에서 연결 전에 어떤 권한을 확인해야 하나요?
Agent가 읽을 수 있는 저장소와 파일, 실행 이벤트, 토큰이 허용하는 작업, 조직 및 저장소 수준의 정책을 각각 대조하십시오. 정책상 허용된 작업과 실제 워크플로 권한이 일치하는지 시험 실행 기록으로 확인해야 합니다.
| 주체 | 허용할 작업 | 검수 증거 |
|---|---|---|
| Agent | 필요한 저장소 내용 읽기, 변경 제안 작성 | 워크플로 권한 설정과 실행 로그 |
| Safe Outputs 후속 작업 | 검수 정책에 맞는 제한된 출력 처리 | 승인 규칙, 검사 결과, 실패 시 동작 |
| 사람 검토자 | 제안을 확인하고 승인 또는 거부 | 검토 기록과 승인자 식별 정보 |
| Mac CI | 승인된 입력으로 빌드·테스트·서명 | 별도 워크플로 설정과 실행 기록 |
이 표는 실제 설정을 기록할 양식이지, 제품의 모든 기본 권한을 대신하는 설명이 아닙니다. 특히 저장소 쓰기, 요청 생성, 병합 또는 배포를 허용하는지는 조직의 정책에 맞춰 각각 결정해야 합니다.
격리 검수는 권한과 실행 환경을 따로 봅니다
토큰이 읽기 전용이어도 실행 환경 전체가 안전하다는 뜻은 아닙니다. 샌드박스의 적용 방식, 네트워크 접근, 사용자 정의 실행 단계, 마운트와 예외 설정을 나눠 확인하십시오. 격리 기능의 종류와 상태는 변경될 수 있으므로, 이번 검수 시점의 공식 보안 아키텍처를 기준으로 기록해야 합니다.
Safe Outputs가 사람 검토나 브랜치 보호를 대신할 수 있나요?
대신한다고 간주하지 마십시오. Safe Outputs는 문서에 정해진 출력 처리 경로와 정책을 확인하는 수단입니다. 제안, 감지 결과, 사람의 승인, 실제 저장소 반영은 서로 다른 상태로 기록해야 합니다. Safe Outputs의 공식 동작 설명
검수할 때는 허용된 네트워크 대상과 사용자 정의 단계가 있는지 먼저 확인합니다. 다음으로 마운트된 경로에 저장소 외부 데이터나 비밀값이 들어가는지 살펴봅니다. 정책 예외가 필요하면 요청자, 사유, 적용 범위와 만료 또는 재검토 조건을 남기십시오. 컨테이너나 마이크로 가상 머신의 존재만으로 호스트 격리를 입증했다고 판단해서는 안 됩니다.
서명 자격 증명은 Agent 환경에서 분리합니다
Agent 단계가 저장소를 분석하는 데 필요하지 않은 생산 서명 키, 인증서, 비밀 환경 변수까지 읽을 수 있다면 접근 범위가 과도합니다. 비밀값의 설정 위치뿐 아니라 어떤 이벤트에서 어떤 작업에 전달되는지도 확인하십시오. 이벤트와 워크플로 권한에 따른 비밀값 동작은 GitHub Actions 이벤트 문서와 실제 설정을 함께 대조해야 합니다.
Agent 워크플로와 Mac CI가 서명 자격 증명을 분리해 쓰려면 어떻게 해야 하나요?
Agent 워크플로에는 분석에 필요한 접근만 부여하고, 서명 자격 증명은 별도 Mac CI의 승인된 서명 작업에서만 사용할 수 있도록 구성하십시오. 설정 화면의 존재만 확인하지 말고, Agent 실행 로그와 Mac CI 로그에서 자격 증명 접근 경로가 분리되는지 시험해야 합니다.
코드 서명은 비밀값 하나를 추가하는 것으로 끝나지 않습니다. 프로비저닝 프로파일은 앱 ID와 개발 팀 등 서명에 필요한 정보를 담으며, 생성과 관리 절차는 Apple의 프로비저닝 프로파일 안내를 기준으로 확인할 수 있습니다. 프로파일과 인증서의 배포, 보관, 갱신 책임도 Mac CI 운영 절차에 명시하십시오.
출력 승인과 실패 처리는 로그로 입증합니다
Safe Outputs 검사 실행 기록은 출력이 안전하다는 보증이나 자동 승인 기록과 같지 않습니다. 감지 결과가 경고 또는 실패일 때 작업이 중단되는지, 격리되는지, 사람에게 전달되는지 실제로 시험해야 합니다. Safe Outputs 문서에서 검사와 출력 처리의 동작을 확인한 뒤 팀 정책과 대조하십시오.
검토 기록에는 Agent 제안, 검사 결과, 사람의 승인 또는 거부, 저장소에 실제 반영된 변경을 별도로 남깁니다. 브랜치 보호와 승인 요건은 저장소 정책에서도 확인하십시오. 감지 단계가 실행됐다는 사실만으로 출력 승인이나 배포 허가를 기록하지 마십시오.
인계 기준은 대표 저장소의 실행 증거로 정합니다
다음 순서로 시험하면 문서상 설정과 실제 동작의 차이를 발견할 수 있습니다.
- [ ] 대표 iOS 저장소와 승인된 시험용 변경을 정하고, 적용할 조직·저장소 정책을 기록합니다.
- [ ] Agent가 접근할 저장소, 토큰 권한, 실행 이벤트와 비밀값 목록을 대조합니다.
- [ ] 사용자 정의 단계, 네트워크 허용 목록, 마운트와 예외 설정을 확인합니다.
- [ ] 변경 제안과 Safe Outputs 감지 결과를 시험하고, 경고 또는 실패가 났을 때의 처리를 관찰합니다.
- [ ] 사람 검토 뒤 승인된 변경만 별도 Mac CI로 전달되는지 확인합니다.
- [ ] Xcode 빌드, 테스트와 서명 작업의 입력, 권한, 로그와 최종 결과를 보관합니다.
아래 표는 실행 전후에 남길 인계 증거와 보류 조건을 구분합니다.
| 검수 지표 | 통과 증거 | 보류 조건 |
|---|---|---|
| 실행 위치 | Agent 단계와 Mac CI 단계가 워크플로 및 로그에서 구별됨 | Runner 범위가 최신 공식 문서와 대조되지 않음 |
| 권한 | 토큰과 저장소 접근이 승인된 작업에 한정됨 | 쓰기 권한이나 실행 이벤트의 근거가 불명확함 |
| 격리 | 네트워크, 사용자 정의 단계, 마운트와 예외가 기록됨 | 기본 권한만으로 호스트 격리를 판단함 |
| 자격 증명 | Agent와 서명 단계의 접근 경계가 로그로 구분됨 | Agent가 생산 서명 자격 증명에 접근할 수 있음 |
| 출력과 인계 | 제안, 감지, 사람 승인, Mac CI 결과가 각각 확인됨 | 감지 실행을 승인 또는 배포 허가로 간주함 |
장기적으로는 이 검수 결과를 저장소 템플릿과 릴리스 승인 절차에 반영하십시오. 별도 Mac 환경이 필요한지 판단할 때는 실제로 필요한 Xcode 작업과 서명 책임을 먼저 목록화해야 합니다. 현재 자체 보유 환경은 구매와 유지 관리가 필요하고, 범용 클라우드 실행 환경은 macOS 작업과 동일한 실행 조건을 보장하지 않으며, Agent와 빌드 단계를 한곳에 합치면 자격 증명 경계가 흐려질 수 있습니다. 단기 검증이나 임시 용량이 필요하다면 MESHLAUNCH의 원격 Mac 임대 비용 정보와 서비스 안내를 확인한 뒤 실제 설정과 인도 조건을 검수하십시오. 자체 하드웨어 인터페이스가 필요하거나 지속적인 고부하 운영을 직접 통제해야 한다면 임대보다 자체 Mac 운영이 더 적합할 수 있습니다.