Menggunakan token akses pribadi
Layanan Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019
Anda dapat menggunakan token akses pribadi (PAT) sebagai kata sandi alternatif untuk mengautentikasi ke Azure DevOps. Dalam artikel ini, kami menunjukkan kepada Anda cara membuat, menggunakan, memodifikasi, dan mencabut PATs untuk Azure DevOps.
Video berikut menunjukkan kepada Anda cara membuat dan menggunakan PAT.
Tentang PAT
Token akses pribadi berisi kredensial keamanan Anda untuk Azure DevOps. PAT mengidentifikasi Anda, organisasi Anda yang dapat diakses, dan cakupan akses. Dengan demikian, kredensial ini sama pentingnya dengan kata sandi, jadi Anda harus memperlakukannya dengan cara yang sama.
Jika Anda bekerja dengan alat Microsoft, maka akun Microsoft Anda (MSA) atau Microsoft Entra ID berlaku dan merupakan pendekatan yang didukung baik. Tapi, jika Anda bekerja dengan alat pihak ketiga yang tidak mendukung akun Microsoft atau Microsoft Entra - atau Anda tidak mau memberikan kredensial primer ke alat - gunakan PAT untuk membatasi risiko.
Anda dapat membuat dan mengelola PAT dengan salah satu cara berikut:
- antarmuka pengguna di pengaturan pengguna Anda, yang dijelaskan secara terperinci dalam artikel ini
- melalui PAT Lifecycle Management API
Untuk menyiapkan PAT untuk alat non-Microsoft, gunakan manajer kredensial Git atau buat secara manual. Sebaiknya tinjau panduan autentikasi kami untuk membantu Anda memilih mekanisme autentikasi yang benar. Untuk proyek yang lebih kecil yang membutuhkan solusi yang tidak terlalu rumit, PAT adalah alternatif sederhana. Kecuali pengguna Anda menggunakan manajer kredensial, mereka harus selalu memasukkan kredensial secara manual.
Membuat PAT
Masuk ke organisasi Anda (
https://dev.azure.com/{yourorganization}).Dari halaman beranda Anda, buka pengaturan
pengguna dan pilih Token akses pribadi.
Pilih + Token Baru.
Beri nama token Anda, pilih organisasi tempat Anda ingin menggunakan token, lalu atur token Anda kedaluwarsa secara otomatis setelah jumlah hari yang ditetapkan.
Pilih cakupan token ini untuk mengotorisasi tugas spesifik Anda.
Misalnya, untuk membuat token guna mengaktifkan agen build dan rilis untuk mengautentikasi ke Azure DevOps Services, batasi cakupan token Anda ke Kumpulan Agen (Baca & kelola). Untuk membaca peristiwa log audit, dan mengelola dan menghapus aliran, pilih Baca Log Audit, lalu pilih Buat.
Catatan
Anda mungkin dibatasi untuk membuat PAT dengan cakupan penuh. Jika seperti itu, Admin Azure DevOps di Microsoft Entra ID telah mengaktifkan kebijakan yang membatasi Anda ke set cakupan kustom khusus yang telah ditentukan. Untuk informasi selengkapnya, lihat Mengelola PAT dengan kebijakan/Membatasi pembuatan EK yang tercakup penuh. Untuk PAT khusus yang ditentukan, cakupan yang diperlukan untuk mengakses API Tata Kelola Komponen,
vso.governance, tidak dapat dipilih di UI.Setelah selesai, salin token dan simpan di lokasi yang aman. Untuk keamanan Anda, keamanan tidak ditampilkan lagi.
Peringatan
Perlakukan dan gunakan PAT seperti kata sandi Anda dan rahasiakan.
Gunakan PAT Anda di mana saja kredensial pengguna Anda diperlukan untuk autentikasi di Azure DevOps.
Penting
Untuk organisasi yang didukung oleh MICROSOFT Entra ID, Anda memiliki waktu 90 hari untuk masuk dengan PAT baru Anda, jika tidak, organisasi dianggap tidak aktif. Untuk informasi selengkapnya, lihat Frekuensi masuk pengguna untuk Akses Bersyarat.
Notifications
Pengguna menerima dua pemberitahuan selama masa pakai PAT - satu saat dibuat dan tujuh hari lainnya sebelum kedaluwarsa.
Setelah membuat PAT, Anda menerima pemberitahuan yang mirip dengan contoh berikut. Pemberitahuan ini mengonfirmasi bahwa PAT Anda telah ditambahkan ke organisasi Anda.
Gambar berikut menunjukkan contoh pemberitahuan tujuh hari sebelum PAT Anda kedaluwarsa.
Untuk informasi selengkapnya, lihat Mengonfigurasi server SMTP dan menyesuaikan email untuk pemberitahuan dan permintaan umpan balik.
Pemberitahuan tak terduga
Jika Anda menerima pemberitahuan PAT yang tidak terduga, administrator atau alat mungkin telah membuat PAT atas nama Anda. Lihat contoh berikut.
- Saat Anda menyambungkan ke repositori Azure DevOps Git melalui git.exe. ini membuat token dengan nama tampilan seperti "git:
https://MyOrganization.visualstudio.com/di MyMachine." - Saat Anda atau administrator menyiapkan penyebaran aplikasi web Azure App Service, ia membuat token dengan nama tampilan seperti "Service Hooks: : Azure App Service: : Menyebarkan aplikasi web."
- Saat Anda atau administrator menyiapkan pengujian beban web sebagai bagian dari alur, ia membuat token dengan nama tampilan seperti "WebAppLoadTestCDIntToken."
- Saat Ekstensi Olahpesan Integrasi Microsoft Teams disiapkan, ekstensi ini membuat token dengan nama tampilan seperti "Integrasi Microsoft Teams."
Peringatan
Jika Anda yakin bahwa PAT ada dalam kesalahan, kami sarankan Anda mencabut PAT. Kemudian, ubah kata sandi Anda. Sebagai pengguna Microsoft Entra, hubungi administrator Anda untuk melihat apakah organisasi Anda digunakan dari sumber atau lokasi yang tidak diketahui. Lihat juga FAQ tentang secara tidak sengaja memeriksa PAT ke repositori GitHub publik.
Menggunakan PAT
PAT Anda adalah identitas Anda dan mewakili Anda ketika Anda menggunakannya, sama seperti kata sandi.
Git
Interaksi Git memerlukan nama pengguna, yang dapat berupa apa pun kecuali string kosong.
Untuk menggunakan PAT dengan autentikasi dasar HTTP, gunakan Base64-encode untuk $MyPat, yang disertakan dalam blok kode berikut.
Di PowerShell, masukkan kode berikut.
$MyPat = 'yourPat'
$headerValue = "Authorization: Basic " + [Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes(":" + $MyPat))
$env:GIT_AUTH_HEADER = $headerValue
git --config-env=http.extraheader=GIT_AUTH_HEADER clone https://dev.azure.com/yourOrgName/yourProjectName/_git/yourRepoName
Agar token Anda lebih aman, gunakan manajer info masuk sehingga Anda tidak perlu memasukkan kredensial Anda setiap saat. Kami merekomendasikan Git Credential Manager. Git untuk Windows diperlukan.
Repositori yang ada
Untuk repositori yang ada, jika Anda sudah menambahkan asal menggunakan nama pengguna, jalankan perintah berikut terlebih dahulu.
git remote remove origin
Jika tidak, jalankan perintah berikut.
git remote add origin https://<PAT>@<company_machineName>.visualstudio.com:/<path-to-git-repo> path to git repo = <project name>/_git/<repo_name> git push -u origin --all
Menggunakan PAT dalam kode Anda
Anda dapat menggunakan PAT dalam kode Anda.
Jika Anda ingin memberikan PAT melalui header HTTP, pertama-tama konversikan ke string Base64. Contoh berikut menunjukkan cara mengonversi ke Base64 menggunakan C#.
Authorization: Basic BASE64_USERNAME_PAT_STRING
String yang dihasilkan kemudian dapat disediakan sebagai header HTTP dalam format berikut.
Sampel berikut menggunakan kelas HttpClient di C#.
public static async void GetBuilds()
{
try
{
var personalaccesstoken = "PATFROMWEB";
using (HttpClient client = new HttpClient())
{
client.DefaultRequestHeaders.Accept.Add(
new System.Net.Http.Headers.MediaTypeWithQualityHeaderValue("application/json"));
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Basic",
Convert.ToBase64String(
System.Text.ASCIIEncoding.ASCII.GetBytes(
string.Format("{0}:{1}", "", personalaccesstoken))));
using (HttpResponseMessage response = client.GetAsync(
"https://dev.azure.com/{organization}/{project}/_apis/build/builds?api-version=5.0").Result)
{
response.EnsureSuccessStatusCode();
string responseBody = await response.Content.ReadAsStringAsync();
Console.WriteLine(responseBody);
}
}
}
catch (Exception ex)
{
Console.WriteLine(ex.ToString());
}
}
Tip
Saat Anda menggunakan variabel, tambahkan $ di awal string, seperti dalam contoh berikut.
public static async void GetBuilds()
{
try
{
var personalaccesstoken = "PATFROMWEB";
using (HttpClient client = new HttpClient())
{
client.DefaultRequestHeaders.Accept.Add(
new System.Net.Http.Headers.MediaTypeWithQualityHeaderValue("application/json"));
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Basic",
Convert.ToBase64String(
System.Text.ASCIIEncoding.ASCII.GetBytes(
string.Format("{0}:{1}", "", personalaccesstoken))));
using (HttpResponseMessage response = client.GetAsync(
$"https://dev.azure.com/{organization}/{project}/_apis/build/builds?api-version=5.0").Result)
{
response.EnsureSuccessStatusCode();
string responseBody = await response.Content.ReadAsStringAsync();
Console.WriteLine(responseBody);
}
}
}
catch (Exception ex)
{
Console.WriteLine(ex.ToString());
}
}
Saat kode Anda berfungsi, saat yang tepat untuk beralih dari autentikasi dasar ke OAuth.
Untuk informasi selengkapnya dan contoh cara menggunakan PATs, lihat artikel berikut ini:
Mengubah PAT
Anda dapat meregenerasi atau memperluas PAT, dan memodifikasi cakupannya. Setelah regenerasi, PAT sebelumnya tidak lagi diotorisasi.
Dari beranda Anda, buka pengaturan pengguna Anda, lalu pilih Profil.
Di bawah Keamanan, pilih Token akses pribadi. Pilih token yang ingin Anda ubah, lalu Edit.
Edit nama token, kedaluwarsa token, atau cakupan akses yang terkait dengan token, lalu pilih Simpan.
Mencabut PAT
Anda dapat mencabut PAT kapan saja, karena berbagai alasan.
Dari beranda Anda, buka pengaturan pengguna Anda, lalu pilih Profil.
Di bawah Keamanan, pilih Token akses pribadi. Pilih token yang ingin Anda cabut aksesnya, lalu pilih Cabut.
Pilih Cabut dalam dialog konfirmasi.
Artikel terkait
- Tentang keamanan, autentikasi, dan otorisasi
- Izin dan akses default untuk Azure DevOps
- Mencabut PAT pengguna (untuk admin)
- Mengelola perwakilan layanan dan identitas terkelola di Azure DevOps
Tanya Jawab Umum
T: Apa yang terjadi pada PAT jika akun pengguna dinonaktifkan?
A: Setelah pengguna dihapus dari Azure DevOps, PAT tidak valid dalam waktu 1 jam. Jika organisasi Anda tersambung ke ID Microsoft Entra, PAT juga tidak valid di ID Microsoft Entra, karena milik pengguna. Kami menyarankan agar pengguna memutar PAT mereka ke pengguna atau akun layanan lain untuk menjaga layanan tetap berjalan.
T: Apakah ada cara untuk memperbarui PAT melalui REST API?
A: Ya, ada cara untuk memperbarui, mengelola, dan membuat PATs menggunakan PAT Lifecycle Management API kami. Untuk informasi selengkapnya, lihat Mengelola PAT menggunakan REST API dan FAQ kami.
T: Dapatkah saya menggunakan autentikasi dasar dengan semua REST API Azure DevOps?
J: Tidak. Anda dapat menggunakan autentikasi dasar dengan sebagian besar REST API Azure DevOps, tetapi organisasi dan profil hanya mendukung OAuth. Untuk informasi selengkapnya, lihat Mengelola PAT menggunakan REST API.
T: Apa yang terjadi jika saya secara tidak sengaja memeriksa PAT saya ke repositori publik di GitHub?
A: Azure DevOps memindai PAT yang diperiksa ke repositori publik di GitHub. Ketika kami menemukan token bocor, kami segera mengirim pemberitahuan email terperinci ke pemilik token dan mencatat peristiwa ke log audit organisasi Azure DevOps Anda. Kecuali Anda menonaktifkan kebijakan Token akses pribadi yang dicabut secara otomatis, kami segera mencabut PAT yang bocor. Kami mendorong pengguna yang terpengaruh untuk segera melakukan mitigasi dengan mencabut token yang bocor dan menggantinya dengan token baru.
Untuk informasi selengkapnya, lihat Mencabut TRO yang bocor secara otomatis.
T: Dapatkah saya menggunakan token akses pribadi sebagai ApiKey untuk menerbitkan paket NuGet ke umpan Azure Artifacts menggunakan baris perintah dotnet/nuget.exe?
J: Tidak. Azure Artifacts tidak mendukung penerusan token akses pribadi sebagai ApiKey. Saat menggunakan lingkungan pengembangan lokal, sebaiknya instal Penyedia Kredensial Artefak Azure untuk mengautentikasi dengan Azure Artifacts. Untuk mengetahui informasi selengkapnya, lihat contoh berikut: dotnet, NuGet.exe. Jika Anda ingin menerbitkan paket menggunakan Azure Pipelines, gunakan tugas NuGet Authenticate untuk mengautentikasi dengan contoh umpan Anda.
T: Mengapa PAT saya berhenti bekerja?
A: Autentikasi PAT mengharuskan Anda untuk secara teratur masuk ke Azure DevOps menggunakan alur autentikasi lengkap. Setiap 30 hari sekali cukup untuk banyak orang, tetapi Anda mungkin perlu masuk lebih sering daripada itu tergantung pada konfigurasi Microsoft Entra Anda. Jika PAT Anda berhenti berfungsi, pertama-tama coba masuk ke organisasi Anda, pastikan Anda melalui perintah autentikasi lengkap. Jika PAT Anda masih tidak berfungsi setelah itu, periksa untuk melihat apakah PAT Anda telah kedaluwarsa.
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk