Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020
Azure DevOps와 통합되어 사용자 리소스에 액세스하고 프로그래밍 방식으로 프로세스를 자동화하는 안전하고 확장 가능한 애플리케이션 및 서비스를 빌드합니다. 내부 자동화 도구를 만들든 상용 제품을 빌드하든 관계없이 Azure DevOps는 통합 요구 사항을 지원하는 강력한 API 및 최신 인증 옵션을 제공합니다.
Azure DevOps와 통합하는 이유는 무엇인가요?
Azure DevOps 통합을 통해 다음을 수행할 수 있습니다.
🔧 워크플로 자동화
- 고객 보고서에서 자동으로 버그 만들기 및 추적
- 사용자 지정 대시보드에서 작업 항목 모니터링 및 상태 표시
- Azure DevOps와 외부 시스템 간의 데이터 동기화
- Azure DevOps 데이터에서 보고서 및 분석 생성
🏗️ 상용 솔루션 빌드
- Azure DevOps 고객을 위한 마켓플레이스 확장 개발
- Azure DevOps와 통합되는 SaaS 제품 만들기
- Azure DevOps 서비스에 연결하는 모바일 앱 빌드
- 엔터프라이즈 시스템과 Azure DevOps 통합
시작: 경로 선택
🚀 빠른 시작 옵션
| 필요 | 권장되는 접근 방식 | 가에 적합한 |
|---|---|---|
| 간단한 자동화 | 개인용 액세스 토큰이 있는 REST API(PAT) | 스크립트, 개인 도구 |
| 프로덕션 애플리케이션 | 관리 ID가 있는 .NET 클라이언트 라이브러리 | 엔터프라이즈 앱, Azure 호스팅 서비스 |
| 대화형 애플리케이션 | Microsoft Entra 인증 | 사용자 연결 앱, 데스크톱 도구 |
| 사용자 지정 UI 구성 요소 | Azure DevOps 확장 | 팀 사용자 지정, 마켓플레이스 제품 |
🔐 인증: 보안 우선
올바른 인증 방법을 선택합니다.
✅ 프로덕션에 권장되는 사항:
- 관리 ID - Azure 호스팅 애플리케이션의 경우(가장 안전함)
- 서비스 주체 - CI/CD 파이프라인 및 자동화된 서비스의 경우
- Microsoft Entra ID - OAuth 흐름이 필요한 사용자 연결 애플리케이션의 경우
⚡ 빠른 개발:
- PAT(개인용 액세스 토큰) - 테스트 및 개인 자동화 전용
❌ 프로덕션에서 사용하지 마세요.
- 사용자 이름/암호 인증(사용되지 않음)
- 소스 코드의 하드 코드된 자격 증명
- 지나치게 광범위한 권한 범위
개발 방법
🔌 REST API 통합
최적 대상: 직접 HTTP 호출, 플랫폼에 구애받지 않은 개발, 간단한 자동화
**Key benefits:**
- Works with any programming language
- Full control over HTTP requests and responses
- Lightweight integration for simple scenarios
- Easy to debug and test
**Get started:**
- [Learn REST API basics](./how-to/call-rest-api.md)
- [Browse API reference](/rest/api/azure/devops/)
- [Try APIs in the browser](https://docs.microsoft.com/rest/api/azure/devops/)
📚 .NET 클라이언트 라이브러리
최적 대상: C# 애플리케이션, 엔터프라이즈 개발, 복잡한 통합
**Key benefits:**
- Strongly typed APIs with IntelliSense support
- Built-in retry logic and error handling
- Async/await patterns for better performance
- Production-ready authentication options
**Get started:**
- [.NET client library samples](./get-started/client-libraries/samples.md)
- [Authentication guidance](./get-started/authentication/authentication-guidance.md)
- [Client library concepts](./concepts/dotnet-client-libraries.md)
🔔 이벤트 기반 통합
최적 대상: 실시간 응답, 웹후크 기반 자동화, 외부 시스템 동기화
**Key benefits:**
- Real-time event notifications
- Reduced polling and improved efficiency
- Support for multiple event types
- Easy integration with external services
**Get started:**
- [Service hooks overview](../service-hooks/overview.md)
- [Webhook configuration guide](../service-hooks/services/webhooks.md)
- [Event reference documentation](../service-hooks/events.md)
🧩 플랫폼 확장
최적 대상: 사용자 지정 UI 구성 요소, 팀별 기능, 마켓플레이스 제품
**Key benefits:**
- Native integration with Azure DevOps UI
- Access to platform APIs and services
- Distribution through Visual Studio Marketplace
- Rich customization capabilities
**Get started:**
- [Extension development overview](../extend/overview.md)
- [Extension samples and tutorials](../extend/develop/samples-overview.md)
- [Marketplace publishing guide](../extend/publish/overview.md)
아키텍처 패턴
🏛️ 권장 아키텍처
마이크로 서비스 통합:
Azure Function/App Service → Managed Identity → Azure DevOps APIs
- Secure, serverless integration
- Automatic credential management
- Scalable and cost-effective
엔터프라이즈 애플리케이션:
On-premises App → Service Principal → Azure DevOps REST APIs
- Certificate-based authentication
- Centralized credential management
- Audit logging and compliance
사용자 연결 애플리케이션:
Web/Mobile App → Microsoft Entra OAuth → Azure DevOps on behalf of user
- User consent flows
- Secure token management
- Granular permission control
보안 및 규정 준수
🛡️ 보안 모범 사례
인증 보안:
- ✅ 가능하면 관리 ID 사용
- ✅ 적절한 토큰 새로 고침 논리 구현
- ✅ 최소 권한 원칙 적용
- ✅ 모든 API 호출에 감사 로깅 사용
- ❌ 소스 제어에 자격 증명을 커밋하지 마세요.
- ❌ 지나치게 광범위한 PAT 범위를 사용하지 마세요.
애플리케이션 보안:
- 적절한 오류 처리 및 로깅 구현
- 모든 통신에 HTTPS 사용
- 모든 입력 데이터의 유효성 검사
- 속도 제한을 원활하게 처리
- Azure Key Vault에 중요한 데이터 저장
규정 준수 고려 사항:
- Azure DevOps 보안 개요 검토
- 데이터 보존 요구 사항 이해
- 적절한 액세스 제어 및 감사 구현
- 업계별 규정 준수 지침 준수
리소스 및 다음 단계
📖 필수 설명서
핵심 개념:
- 인증 지침 - 올바른 인증 방법 선택
- Microsoft Entra 통합 - OAuth 및 최신 인증 패턴
- 통합 모범 사례 - 프로덕션 준비 개발 패턴
API 참조:
- Azure DevOps REST API - 전체 API 설명서
- .NET 클라이언트 라이브러리 - 관리되는 클라이언트 라이브러리 정보
- 서비스 후크 참조 - 이벤트 기반 통합
코드 샘플:
- .NET 클라이언트 샘플 - 프로덕션 준비 C# 예제
- Azure DevOps 인증 샘플 - 인증 예제
- 확장 샘플 - 플랫폼 확장 예제
🎯 빠른 작업
지금 빌드를 시작합니다.
- 인증 설정 - 인증 방법 선택
- REST API 사용해 보기 - 첫 번째 API 호출
- 클라이언트 라이브러리 샘플 실행 - 작업 코드 예제 참조
- 보안 사례 검토 - 처음부터 안전하게 빌드
도움이 필요하세요?
- Azure DevOps 개발자 커뮤니티 - 질문하고 도움말 보기
- 스택 오버플로 - 커뮤니티 지원 및 예제
- GitHub 샘플 리포지토리 - 작업 코드 예제
팁 (조언)
Azure DevOps 통합이 처음이신가요? 인증 지침으로 시작하여 옵션을 이해한 다음 REST API 빠른 시작을 시도하여 첫 번째 성공적인 API 호출을 수행합니다.