APIDOG 8월 업데이트: GitHub Enterprise Cloud, 강화된 SSO 거버넌스 및 감사 기능 강화 관리자 API

Apidog 2.8.41부터 2.8.44까지 네 번의 공개 릴리스를 통해 8월에는 엔터프라이즈 API 운영의 세 가지 연결된 부분인 통제된 Git 연결성, ID 기반 프로젝트 접근, 그리고 더욱 유용하고 추적 가능한 API 기반 관리를 강화했습니다.

엔터프라이즈 API 팀은 API 플랫폼 자체 외부 시스템을 통해 리포지토리, ID, 멤버십을 점점 더 많이 관리하고 있습니다. 이번 달 Apidog은 이러한 연결을 개선하는 동시에 프로젝트 설정, 가져오기, 브랜치, 문서화, CLI 워크플로 및 테스트 실행 전반에 걸쳐 집중적인 안정성 업데이트를 제공합니다.

주요 업데이트는 다음과 같습니다.

GitHub Enterprise Cloud: 전용 *.ghe.com 도메인의 데이터 레지던시 배포 환경에 Apidog을 연결합니다.
SSO 거버넌스 및 프로젝트 접근: 엔터프라이즈 SSO 세션을 조직 업무에 집중시키고 SAML 그룹 매핑을 통해 프로젝트 권한을 초기화합니다.
엔터프라이즈 관리 API: 더 유용한 조직 구성원 데이터를 검색하고, 명시적인 프로젝트 접근 초기화를 통해 팀 온보딩을 자동화하며, 지원되는 API 기반 관리 작업을 감사 추적에 포함시킵니다.

추가 환경, 정책, 국제화, 사양 및 워크플로 개선 사항은 세 가지 주요 업데이트 이후에 요약되어 있습니다.

1. ☁️ 데이터 레지던시 워크플로를 위한 GitHub Enterprise Cloud

데이터 레지던시를 사용하는 GitHub Enterprise Cloud 고객은 공개 github.com 도메인 대신 전용 *.ghe.com 도메인에 리포지토리를 호스팅할 수 있습니다. 지금까지는 조직의 기존 GitHub 환경 외부로 관리되는 리포지토리를 이동하지 않고 Apidog의 Git 워크플로를 사용하려는 팀에게는 이로 인해 공백이 발생했습니다.

Apidog GitHub Enterprise Cloud connection for data-residency workflows

조직의 `*.ghe.com` 호스트에 연결

이제 조직 관리자는 OAuth 앱 클라이언트 ID 및 클라이언트 시크릿과 함께 GitHub Enterprise Cloud 호스트를 구성할 수 있습니다. 승인 흐름은 구성된 엔터프라이즈 호스트를 사용하므로 Apidog이 지원되는 Git 작업에 필요한 조직, 리포지토리, 브랜치 및 파일에 액세스할 수 있습니다.

이 연결은 세 가지 실제 워크플로에 적용됩니다.

Git 연결: 조직에서 제어하는 리포지토리 및 브랜치를 통해 API 정의와 작업합니다.
리포지토리 가져오기: 엔터프라이즈 리포지토리에서 OpenAPI 또는 Swagger 파일을 Apidog으로 가져옵니다.
OpenAPI 백업: API 정의를 팀에서 선택한 엔터프라이즈 리포지토리 및 브랜치에 백업합니다.

그 결과는 연속성입니다. 팀은 Apidog의 Git 기반 가져오기, 백업 및 협업 워크플로를 사용하면서 리포지토리 거버넌스 및 데이터 레지던시 모델을 유지할 수 있습니다.

범위: 이 업데이트는 전용 *.ghe.com SaaS 도메인의 GitHub Enterprise Cloud 데이터 레지던시 배포에 한정됩니다. 자체 호스팅 GitHub Enterprise Server 도메인에 대한 일반적인 지원은 추가되지 않습니다.

2. 🛡️ 더욱 강력한 SSO 거버넌스 및 프로젝트 접근

엔터프라이즈 SSO는 사용자 인증 이상의 역할을 해야 합니다. 세션을 조직의 의도된 작업 공간에 집중시키고, ID 공급자 멤버십을 작업이 이루어지는 프로젝트에 대한 예측 가능한 접근으로 전환해야 합니다.

엔터프라이즈 SSO 세션을 조직 업무에 집중시키기

SSO 세션 격리(isolation)를 활성화하면 Apidog은 개인 팀 및 프로젝트로의 진입점을 줄입니다. 또한 조직 업무를 개인 공간으로 이동, 복사 또는 복제할 수 있는 특정 작업을 제한합니다. 사용자는 SSO 세션과 관련된 조직 및 팀에 집중하는 반면, 관리자는 엔터프라이즈 워크플로와 개인 워크플로 간의 더 명확한 분리를 확보합니다.

이러한 제어는 SSO 세션 격리를 활성화하지 않는 조직의 일반적인 경험을 변경하지 않고도 의도된 접근 경계를 강화합니다.

팀 멤버십을 프로젝트 수준 접근으로 확장

SAML 그룹 매핑은 이제 동기화된 팀의 프로젝트에 대한 접근을 초기화함으로써 조직 및 팀 멤버십을 넘어 확장됩니다. 초기 프로젝트 역할은 간단한 규칙을 따릅니다.

동기화된 팀 역할	팀 내 프로젝트에 대한 초기 접근 권한
팀 관리자	편집자
기타 팀 구성원	읽기 전용

매핑된 사용자가 팀에서 제거되면 Apidog은 관련 프로젝트 멤버십도 동기화합니다. 이는 ID 공급자 그룹, 팀 역할 및 사용자가 로그인 후 필요로 하는 프로젝트 권한 간의 운영 격차를 해소합니다.

중요성: 관리자는 온보딩 또는 오프보딩 후 프로젝트 멤버십을 수정하는 데 시간을 덜 소비하고, 사용자는 명확하고 일관된 초기 접근 수준으로 팀 프로젝트에 진입합니다.

3. 📋 더욱 완벽하고 감사 가능한 엔터프라이즈 관리 API

엔터프라이즈 관리자는 구성원을 재고 파악하고, ID 시스템을 연결하며, 일상적인 관리를 자동화하기 위해 API에 의존하는 경우가 많습니다. 이러한 워크플로는 API가 유용한 구성원 데이터를 반환하고, 온보딩 동작이 명시적이고 보호적이며, 자동화된 작업이 거버넌스 팀에 계속 표시될 때만 신뢰할 수 있습니다.

더 유용한 조직 구성원 데이터 검색

조직 구성원 API는 이제 기존 멤버십 정보와 함께 이메일 주소 및 더 신뢰할 수 있는 구성원 이름을 제공합니다.

GET /v1/organizations/{organizationId}/members

구성원이 별명을 설정하지 않은 경우 Apidog은 반환되는 이름에 사용할 수 있는 다른 프로필 정보를 사용할 수 있습니다. 해당 보류 또는 프로비저닝된 기록을 포함하여 사용 가능한 이메일 주소가 없는 구성원은 모호한 누락 필드 대신 명시적인 null 값을 반환합니다.

이는 API를 다음 용도로 더 실용적으로 만듭니다.

구성원 재고 파악: 관리자가 검토에 일반적으로 필요한 정보로 조직 구성원을 식별합니다.
자동 동기화: 외부 ID 및 관리 워크플로에서 안정적인 구성원 데이터를 사용합니다.
액세스 검토: 기본적인 세부 정보를 위해 별도의 수동 CSV 내보내기에 의존하지 않고 멤버십 기록을 비교합니다.

API를 통해 팀 역할 할당 및 프로젝트 접근 초기화

이제 엔터프라이즈 관리자는 이메일을 통해 사용자를 팀에 추가하고, 외부 API를 통해 지원되는 기본 제공 팀 역할을 할당할 수 있습니다.

POST /v1/team-access-grants

각 요청은 팀 역할(관리자, 구성원 또는 게스트)과 팀 내 프로젝트에 대한 접근을 초기화하는 방법을 명시적으로 선택합니다. mapped를 사용하면 Apidog은 기존의 유효한 프로젝트 역할을 유지하면서 선택한 팀 역할에 따라 누락된 프로젝트 접근을 초기화합니다. none을 사용하면 사용자는 프로젝트 구성원 권한을 받지 않고 팀에 가입하므로 접근 권한을 별도로 할당할 수 있습니다.

이 엔드포인트는 아직 조직에 가입하지 않은 사용자를 위한 초대 및 이전에 팀을 떠났던 구성원을 복원하는 것도 지원합니다. 기존의 활성 또는 보류 중인 팀 구성원 및 팀 소유자는 의도하지 않은 변경으로부터 보호되므로 자동화된 온보딩 워크플로에 대해 반복 호출이 더 안전합니다.

범위: 프로젝트 접근 초기화는 사용자가 처음 가입하거나 복원될 때 팀 아래에 이미 존재하는 프로젝트에 적용됩니다. 권한을 지속적으로 동기화하거나 향후 프로젝트에 자동으로 적용되지 않으며, 엔드포인트는 팀 소유자, 청구 관리자 또는 사용자 정의 팀 역할을 할당하지 않습니다.

지원되는 API 기반 관리를 감사 추적에 유지

기존 감사 이벤트에 해당하는 지원되는 외부 관리 API 작업은 이제 감사 추적에 통합됩니다. 이를 통해 거버넌스 팀은 Apidog 인터페이스에서 수행되는 작업과 자동화를 통해 수행되는 지원되는 작업 간의 더 나은 연속성을 확보합니다.

더욱 풍부한 구성원 데이터, 더 안전한 팀 접근 자동화, 그리고 더 넓은 감사 범위가 함께 엔터프라이즈 관리를 자동화하기 쉽게 만들고, 운영 검토에 필요한 가시성을 잃지 않도록 합니다.

범위: 감사 범위는 기존 감사 이벤트와 관련된 지원되는 외부 API 작업에 적용됩니다. 모든 API 요청 또는 관리 엔드포인트의 범용 로깅으로 해석되어서는 안 됩니다.

✨ 추가 개선 사항

8월에는 환경 구성, 엔터프라이즈 정책, 국제화, 사양 워크플로 및 프로젝트 관리 전반에 걸쳐 일련의 집중적인 개선 사항도 포함되었습니다.

엔터프라이즈 및 환경 관리

조직 멤버십 정책: 엔터프라이즈 관리자는 지정된 이메일 주소를 가진 구성원으로 조직 멤버십을 제한하여, 승인된 ID 규칙과 접근 권한을 일치시키는 데 도움을 줍니다.
초대 보상 정책: 조직은 조직 및 해당 팀 또는 프로젝트에서 보낸 초대에 대한 크레딧 보상 및 관련 이메일을 비활성화할 수 있습니다.
더 빠른 모듈 기본 URL 탐색: 프로젝트에 5개 이상의 모듈이 있는 경우, 처음 5개 이후의 항목은 자동으로 축소되며 검색을 통해 사용자는 필요한 서비스 구성을 찾을 수 있습니다.
지역화된 시스템 이메일: Apidog 시스템 이메일은 이제 수신자의 선택된 언어를 따르며, Apidog 언어 기본 설정이 없는 경우 영어로 표시됩니다.
더욱 관리하기 쉬운 조직 소유 팀: 조직 소유자 및 관리자는 각 팀 소유자 및 소유자 상태를 볼 수 있으며, 해당 필드를 기준으로 팀을 검색하거나 필터링하고, 하나 또는 여러 팀의 소유권을 이전할 수 있습니다. 이를 통해 조직 관리 개인 작업 공간을 식별하고 소유권 변경 시 인계하기가 더 쉬워집니다.
더욱 명확해진 프로젝트 구성원 관리: 대량 구성원 편집, 구성원 세부 정보 대화 상자 및 권한 설정이 더 쉬워졌으며, 팀 소유자 역할은 지원되지 않는 변경으로부터 보호됩니다.
세련된 엔터프라이즈 관리 페이지: 더 일관된 레이아웃, 도움말 링크 및 업그레이드 프레젠테이션은 기존 권한 논리를 변경하지 않고도 엔터프라이즈 설정, 정책, 감사 로그, 비밀 스캐너 및 SAML SSO 페이지 전반의 탐색을 개선합니다.

프로젝트 설정, 가져오기 및 사양

프로젝트 생성 중 더 안전한 모드 전환: 일반 모드와 사양 모드 간에 전환할 때 프로젝트 생성 양식에 이미 입력된 정보는 유지됩니다.
개선된 Postman 파일 가져오기: 이제 가져오기는 전역 변수를 지원하고 변수 이름의 공백을 자동으로 처리하여 마이그레이션 후 정리 작업을 줄입니다.
사양 모드에서 더 나은 교차 파일 $ref 지원: 엔드포인트 미리보기는 별도의 OpenAPI 파일에 저장된 지원되는 요청 본문, 스키마 및 응답을 해결할 수 있습니다. 참조된 파일 전체의 스펙트럼 린트, 전체 엔드포인트 참조 및 양식 모드 교차 파일 참조는 이 범위에 포함되지 않습니다.

이러한 개선 사항은 릴리스의 세 가지 주요 엔터프라이즈 워크플로와 경쟁하지 않고도 반복되는 설정 및 관리 마찰을 줄입니다.

🛠️ 주요 버그 수정

8월 릴리스에는 Git 브랜치, OpenAPI 가져오기 및 내보내기, 공유 문서, CLI 생성 데이터 및 테스트 실행 전반의 안정성 문제도 해결되었습니다. 가장 중요한 수정 사항은 세 가지 워크플로 그룹에 속합니다.

더 안전한 브랜치, 가져오기, 내보내기 및 코드 생성 워크플로

Apidog CLI OpenAPI 가져오기가 이제 잘못된 메인 브랜치로 쓰는 대신 사용자가 선택한 브랜치에 씁니다.
하위 브랜치에서 릴리스 문서 내보내기가 더 이상 관련 없는 모듈 또는 빈 폴더의 엔드포인트를 포함하지 않습니다.
다중 브랜치 병합이 엔드포인트, 테스트 시나리오 및 기타 리소스를 대상 브랜치로 더 안정적으로 가져옵니다.
Git 리포지토리 연결 생성 작업이 OpenAPI 가져오기 중에 올바르게 응답합니다.
OpenAPI 및 CLI 내보내기가 의도치 않게 더 넓은 엔드포인트 세트를 포함하는 대신 선택한 모듈, 태그 및 폴더를 이제 존중합니다.
모듈 전체에서 참조되는 스키마가 코드 생성 중 더 안정적으로 유지됩니다.
AND 관련 보안 스키마가 부정확한 내부 표현으로 병합되는 대신 올바르게 내보내집니다.

더 정확한 유효성 검사 및 공유 문서

엄격 모드 응답 유효성 검사가 이제 allOf로 구성된 스키마를 올바르게 처리합니다.
추가 속성을 통해 참조된 스키마가 공유 API 문서에 올바르게 나타납니다.
기본 예제가 공유 문서에 올바르게 표시됩니다.
로그아웃한 사용자가 공개 프로젝트를 방문할 때 Markdown 문서 탭이 완전히 렌더링됩니다.

더욱 신뢰할 수 있는 CLI 데이터 및 테스트 실행

AI 또는 Apidog CLI를 통해 생성된 전역 변수가 더 이상 빈 클라이언트 측 변수 이름을 생성하지 않습니다.
Apidog CLI에 의해 생성된 유효하지 않은 태그 값이 더 이상 프런트엔드 접근 오류를 일으키지 않습니다.
`--scenario` 없이 생성된 프로젝트 수준 테스트 데이터가 데이터 목록에서 계속 표시됩니다.
SSE 요청이 실행되는 동안 전처리 및 후처리 실행 세부 정보가 콘솔에 나타나며, 요청이 완료된 후에만 나타나지 않습니다.
테스트 실행에서 긴 텍스트 데이터 세트 변수를 사용할 때 데이터 세트 이름이 계속 표시됩니다.

이러한 수정 사항은 올바른 워크플로가 잘못된 브랜치 대상, 불완전한 내보내기, 누락된 문서 또는 오해의 소지가 있는 테스트 피드백을 생성할 가능성을 줄입니다.

🌟 의미하는 바

8월의 주요 업데이트는 엔터프라이즈 API 운영 모델의 세 가지 연결된 부분을 강화합니다.

초점	개선 사항	중요한 이유
통제된 Git 연결성	Apidog은 Git 연결, 리포지토리 가져오기 및 OpenAPI 백업을 위해 `*.ghe.com`의 GitHub Enterprise Cloud 데이터 레지던시 호스트에 연결할 수 있습니다.	팀은 조직에서 제어하는 GitHub 환경 및 브랜치 구조에 리포지토리를 유지합니다.
ID-투-프로젝트 접근	SSO 세션은 개인 공간으로의 진입점을 줄이고, SAML 그룹 매핑은 프로젝트 멤버십을 초기화하고 유지합니다.	온보딩 및 오프보딩이 더욱 예측 가능해지며 수동 권한 수정 작업이 줄어듭니다.
감사 가능한 관리	조직 구성원 API는 더 유용한 ID 데이터를 반환하고, 팀 접근 권한 부여 API는 명시적인 프로젝트 접근 초기화를 통해 보호된 팀 온보딩을 자동화하며, 지원되는 외부 관리 작업은 기존 감사 이벤트에 피드백됩니다.	팀은 온보딩, 재고 파악, 접근 검토 및 거버넌스에 필요한 통제 및 가시성을 포기하지 않고 더 많은 관리를 자동화할 수 있습니다.

추가 환경, 정책, 사양 및 안정성 개선 사항은 일상적인 워크플로를 더욱 안정적으로 만들지만, 더 큰 방향은 일관됩니다. 즉, 엔터프라이즈 API 프로그램이 성장함에 따라 리포지토리 거버넌스, ID 접근 및 관리 자동화를 조율하는 것입니다.

💬 대화에 참여하세요

동료 API 엔지니어 및 Apidog 팀과 소통하세요.

실시간 토론 및 지원을 위해 Discord 커뮤니티에 참여하세요.
기술적인 대화를 위해 Slack 커뮤니티에 참여하세요.
최신 업데이트를 위해 X (Twitter) 및 LinkedIn에서 팔로우하세요.

추신. 각 항목별 릴리스 노트를 보려면 Apidog 변경 로그를 참조하십시오. 버전 2.8.41, 2.8.42, 2.8.43 및 2.8.44가 포함됩니다.

감사합니다,
Apidog 팀 드림