Kata sandi aplikasi Bitbucket atau token akses - AWS CodeBuild
Prasyarat Hubungkan Bitbucket dengan kata sandi aplikasi (konsol) Connect Bitbucket dengan token akses (konsol) Hubungkan Bitbucket dengan kata sandi aplikasi atau token akses (CLI)

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Kata sandi aplikasi Bitbucket atau token akses

Prasyarat

Sebelum memulai, Anda harus menambahkan cakupan izin yang tepat ke kata sandi aplikasi Bitbucket atau token akses Anda.

Untuk Bitbucket, kata sandi aplikasi atau token akses Anda harus memiliki cakupan berikut.

  • repository:read: Memberikan akses baca ke semua repositori yang dapat diakses oleh pengguna otorisasi.

  • pullrequest:read: Memberikan akses baca ke permintaan tarik. Jika project Anda memiliki webhook Bitbucket, kata sandi aplikasi atau token akses Anda harus memiliki cakupan ini.

  • webhook: Memberikan akses ke webhook. Jika project Anda memiliki operasi webhook, kata sandi aplikasi atau token akses Anda harus memiliki cakupan ini.

Untuk informasi selengkapnya, lihat Cakupan untuk Bitbucket Cloud REST API dan Bitbucket Cloud OAuth di situs web Bitbucket.

Hubungkan Bitbucket dengan kata sandi aplikasi (konsol)

Untuk menggunakan konsol untuk menghubungkan proyek Anda ke Bitbucket menggunakan kata sandi aplikasi, lakukan hal berikut saat Anda membuat proyek. Untuk informasi, lihat Buat proyek build (konsol).

  1. Untuk penyedia Sumber, pilih Bitbucket.

  2. Untuk Credential, lakukan salah satu hal berikut:

    • Pilih untuk menggunakan kredensil akun untuk menerapkan kredensi sumber default akun Anda ke semua proyek.

      1. Jika Anda tidak terhubung ke Bitbucket, pilih Kelola kredensi akun.

      2. Untuk jenis Kredenal, pilih Kata sandi aplikasi.

    • Jika Anda memilih untuk menggunakan kredensi tingkat akun untuk Layanan, pilih layanan mana yang ingin Anda gunakan untuk menyimpan token Anda dan lakukan hal berikut:

      1. Jika Anda memilih untuk menggunakan Secrets Manager, Anda dapat memilih untuk menggunakan koneksi rahasia yang ada atau membuat rahasia baru, lalu pilih Simpan. Untuk informasi selengkapnya cara membuat rahasia baru, lihatBuat dan simpan token dalam rahasia Secrets Manager.

      2. Jika Anda memilih untuk menggunakan CodeBuild, masukkan nama pengguna dan kata sandi aplikasi Bitbucket Anda, lalu pilih Simpan.

    • Pilih Gunakan kredenal ganti untuk proyek ini hanya untuk menggunakan kredensi sumber kustom untuk mengganti setelan kredensi akun Anda.

      1. Dari daftar kredensi terisi, pilih salah satu opsi di bawah Kata sandi aplikasi.

      2. Anda juga dapat membuat token kata sandi Aplikasi baru dengan memilih buat koneksi kata sandi aplikasi baru dalam deskripsi.

Connect Bitbucket dengan token akses (konsol)

Untuk menggunakan konsol untuk menghubungkan proyek Anda ke Bitbucket menggunakan token akses, lakukan hal berikut saat Anda membuat proyek. Untuk informasi, lihat Buat proyek build (konsol).

  1. Untuk penyedia Sumber, pilih Bitbucket.

  2. Untuk Credential, lakukan salah satu hal berikut:

    • Pilih untuk menggunakan kredensil akun untuk menerapkan kredensi sumber default akun Anda ke semua proyek.

      1. Jika Anda tidak terhubung ke Bitbucket, pilih Kelola kredensi akun.

      2. Untuk tipe Credential, pilih Token akses pribadi.

    • Jika Anda memilih untuk menggunakan kredensi tingkat akun untuk Layanan, pilih layanan mana yang ingin Anda gunakan untuk menyimpan token Anda dan lakukan hal berikut:

      1. Jika Anda memilih untuk menggunakan Secrets Manager, Anda dapat memilih untuk menggunakan koneksi rahasia yang ada atau membuat rahasia baru, lalu pilih Simpan. Untuk informasi selengkapnya cara membuat rahasia baru, lihatBuat dan simpan token dalam rahasia Secrets Manager.

      2. Jika Anda memilih untuk menggunakan CodeBuild, masukkan token akses pribadi Bitbucket Anda, lalu pilih Simpan.

    • Pilih Gunakan kredenal ganti untuk proyek ini hanya untuk menggunakan kredensi sumber kustom untuk mengganti setelan kredensi akun Anda.

      1. Dari daftar kredensi yang terisi, pilih salah satu opsi di bawah Token akses pribadi.

      2. Anda juga dapat membuat token akses pribadi baru dengan memilih buat koneksi token akses pribadi baru dalam deskripsi.

Hubungkan Bitbucket dengan kata sandi aplikasi atau token akses (CLI)

Ikuti langkah-langkah berikut untuk menggunakan AWS CLI untuk menghubungkan proyek Anda ke Bitbucket menggunakan kata sandi aplikasi atau token akses. Untuk informasi tentang menggunakan AWS CLI with AWS CodeBuild, lihatReferensi baris perintah.

  1. Jalankan perintah import-source-credentials: 

    aws codebuild import-source-credentials --generate-cli-skeleton

    Data berformat JSON muncul di output. Salin data ke file (misalnya,import-source-credentials.json) di lokasi di komputer lokal atau contoh di AWS CLI mana diinstal. Ubah data yang disalin sebagai berikut, dan simpan hasil Anda. 

    {
    "serverType": "BITBUCKET",
    "authType": "auth-type",
    "shouldOverwrite": "should-overwrite",
    "token": "token",
    "username": "username"
    }

    Ganti yang berikut ini:

    • server-type: Nilai yang dibutuhkan. Penyedia sumber yang digunakan untuk kredensi ini. Nilai yang valid adalah GITHUB, BITBUCKET, GITHUB_ENTERPRISE, GITLAB, dan GITLAB_SELF_MANAGED.

    • auth-type: Nilai yang dibutuhkan. Jenis otentikasi yang digunakan untuk terhubung ke repositori. Nilai yang valid adalah OAUTH, BASIC_AUTH, PERSONAL_ACCESS_TOKEN, CODECONNECTIONS, dan SECRETS_MANAGER. Untuk GitHub, hanya PERSONAL_ACCESS_TOKEN yang diizinkan. BASIC_AUTH hanya diizinkan dengan kata sandi aplikasi Bitbucket.

    • should-overwrite: Nilai opsional. Setel false untuk mencegah penimpaan kredenal sumber repositori. Setel true untuk menimpa kredenal sumber repositori. Nilai default-nya adalah true.

    • token: Nilai yang dibutuhkan. Untuk GitHub atau Server GitHub Perusahaan, ini adalah token akses pribadi. Untuk Bitbucket, ini adalah token akses pribadi atau kata sandi aplikasi. Untuk CODECONNECTIONS tipe auth-, ini adalah koneksi ARN. Untuk tipe auth-SECRETS_MANAGER, ini adalah ARN rahasia.

    • username: Nilai opsional. Parameter ini diabaikan untuk GitHub dan penyedia sumber Server GitHub Perusahaan.

  2. Untuk menghubungkan akun Anda dengan kata sandi aplikasi atau token akses, alihkan ke direktori yang berisi import-source-credentials.json file yang Anda simpan di langkah 1 dan jalankan import-source-credentials perintah lagi. 

    aws codebuild import-source-credentials --cli-input-json file://import-source-credentials.json

    Data berformat JSON muncul di output dengan Amazon Resource Name (ARN). 

    {
    "arn": "arn:aws:codebuild:region:account-id:token/server-type"
    }
    catatan

    Jika Anda menjalankan import-source-credentials perintah dengan jenis server dan jenis autentikasi yang sama untuk kedua kalinya, token akses yang disimpan diperbarui.

    Setelah akun Anda terhubung dengan kata sandi aplikasi, Anda dapat menggunakannya create-project untuk membuat CodeBuild proyek Anda. Untuk informasi selengkapnya, lihat Buat proyek build (AWS CLI).

  3. Untuk melihat kata sandi aplikasi yang terhubung atau token akses, jalankan list-source-credentials perintah. 

    aws codebuild list-source-credentials

    sourceCredentialsInfosObjek berformat JSON muncul di output: 

    {
        "sourceCredentialsInfos": [
            {
                "authType": "auth-type",
                "serverType": "BITBUCKET", 
                "arn": "arn"
            }
        ]
    }

    sourceCredentialsObjectBerisi daftar informasi kredensial sumber yang terhubung:

    • authTypeIni adalah jenis otentikasi yang digunakan oleh kredensi. Ini bisaOAUTH,BASIC_AUTH,PERSONAL_ACCESS_TOKEN,CODECONNECTIONS, atauSECRETS_MANAGER.

    • serverTypeIni adalah jenis penyedia sumber. Ini bisaGITHUB,GITHUB_ENTERPRISE,BITBUCKET,GITLAB, atauGITLAB_SELF_MANAGED.

    • arnItu adalah ARN dari token.

  4. Untuk memutuskan sambungan dari penyedia sumber dan menghapus kata sandi aplikasi atau token aksesnya, jalankan delete-source-credentials perintah dengan ARN-nya. 

    aws codebuild delete-source-credentials --arn arn-of-your-credentials

    Data berformat JSON dikembalikan dengan ARN dari kredenal yang dihapus. 

    {
    "arn": "arn:aws:codebuild:region:account-id:token/server-type"
    }