Bagikan melalui

Membangun aplikasi aman dengan Azure DevOps

Layanan Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Bangun aplikasi dan layanan yang aman dan dapat diskalakan yang terintegrasi dengan Azure DevOps untuk mengakses sumber daya pengguna dan mengotomatiskan proses secara terprogram. Baik Anda membuat alat otomatisasi internal atau membangun produk komersial, Azure DevOps menyediakan API yang kuat dan opsi autentikasi modern untuk mendukung kebutuhan integrasi Anda.

Mengapa berintegrasi dengan Azure DevOps?

Integrasi Azure DevOps memungkinkan Anda untuk:

🔧 Mengotomatiskan alur kerja

  • Membuat dan melacak bug secara otomatis dari laporan pelanggan
  • Memantau item kerja dan menampilkan status pada dasbor kustom
  • Menyinkronkan data antara Azure DevOps dan sistem eksternal
  • Membuat laporan dan analitik dari data Azure DevOps

🏗️ Membangun solusi komersial

  • Mengembangkan ekstensi marketplace untuk pelanggan Azure DevOps
  • Membuat produk SaaS yang terintegrasi dengan Azure DevOps
  • Membangun aplikasi seluler yang tersambung ke layanan Azure DevOps
  • Mengintegrasikan Azure DevOps dengan sistem perusahaan

Memulai: Pilih jalur Anda

🚀 Opsi cepat mulai

Perlu Pendekatan yang direkomendasikan Pilihan terbaik untuk
Otomatisasi sederhana REST API dengan token akses pribadi (PATs) Skrip, alat pribadi
Aplikasi produksi Pustaka aplikasi klien .NET dengan identitas terkelola Aplikasi perusahaan, layanan yang dihosting Azure
Aplikasi interaktif Autentikasi Microsoft Entra Aplikasi yang berhadapan dengan pengguna, perangkat desktop.
Komponen UI kustom Ekstensi Azure DevOps Penyesuaian tim, produk pasar daring

🔐 Autentikasi: Keamanan terlebih dahulu

Pilih metode autentikasi yang tepat:

✅ Direkomendasikan untuk produksi:

⚡ Pengembangan cepat:

❌ Hindari dalam lingkungan produksi:

  • Autentikasi nama pengguna/kata sandi (tidak digunakan lagi)
  • Kredensial yang dikodekan secara permanen dalam kode sumber
  • Cakupan izin yang terlalu luas

Pendekatan pengembangan

🔌 Integrasi REST API

Terbaik untuk: Panggilan HTTP langsung, pengembangan platform-agnostik, otomatisasi sederhana

**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/)

📚 Pustaka klien .NET

Terbaik untuk: Aplikasi C#, pengembangan perusahaan, integrasi kompleks

**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)

🔔 Integrasi berbasis peristiwa

Terbaik untuk: Respons real time, otomatisasi berbasis webhook, sinkronisasi sistem eksternal

**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)

🧩 Ekstensi platform

Terbaik untuk: Komponen UI kustom, fitur khusus tim, produk marketplace

**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)

Pola arsitektur

🏛️ Arsitektur yang direkomendasikan

Integrasi layanan mikro:

Azure Function/App Service → Managed Identity → Azure DevOps APIs
- Secure, serverless integration
- Automatic credential management
- Scalable and cost-effective

Aplikasi perusahaan:

On-premises App → Service Principal → Azure DevOps REST APIs
- Certificate-based authentication
- Centralized credential management
- Audit logging and compliance

Aplikasi yang berinteraksi dengan pengguna:

Web/Mobile App → Microsoft Entra OAuth → Azure DevOps on behalf of user
- User consent flows
- Secure token management
- Granular permission control

Keamanan dan kepatuhan

🛡️ Praktik terbaik keamanan

Keamanan autentikasi:

  • ✅ Gunakan identitas terkelola jika memungkinkan
  • ✅ Menerapkan logika refresh token yang tepat
  • ✅ Menerapkan prinsip hak istimewa paling sedikit
  • ✅ Mengaktifkan pengelogan audit untuk semua panggilan API
  • ❌ Jangan pernah menerapkan kredensial ke kontrol sumber
  • ❌ Jangan gunakan cakupan PAT yang terlalu luas

Keamanan aplikasi:

  • Menerapkan penanganan dan pengelogan kesalahan yang tepat
  • Gunakan HTTPS untuk semua komunikasi
  • Memvalidasi semua data input
  • Menangani pembatasan laju dengan anggun
  • Menyimpan data sensitif di Azure Key Vault

Pertimbangan kepatuhan:

Sumber daya dan langkah berikutnya

📖 Dokumentasi penting

Konsep inti

Referensi API:

Sampel kode:

🎯 Tindakan cepat

Mulai membangun hari ini:

  1. Menyiapkan autentikasi - Pilih metode autentikasi Anda
  2. Coba REST API - Lakukan panggilan API pertama Anda
  3. Menjalankan sampel pustaka klien - Lihat contoh kode kerja
  4. Tinjau praktik keamanan - Bangun dengan aman sejak awal

Butuh bantuan?

Petunjuk / Saran

Baru dengan integrasi Azure DevOps? Mulailah dengan panduan autentikasi untuk memahami opsi Anda, lalu coba mulai cepat REST API untuk melakukan panggilan API pertama Anda yang berhasil.

  • Last updated on