Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Konfigurasikan GitHub untuk AppFabric
GitHubadalah platform dan layanan berbasis cloud untuk pengembangan perangkat lunak dan kontrol versi menggunakan Git, memungkinkan pengembang untuk menyimpan dan mengelola kode mereka. Ini menyediakan kontrol versi terdistribusi dari Git plus kontrol akses, pelacakan bug, permintaan fitur perangkat lunak, manajemen tugas, integrasi berkelanjutan, dan wiki untuk setiap proyek.
Anda dapat menggunakan keamanan AWS AppFabric untuk menerima log audit dan data pengguna dariGitHub, menormalkan data ke dalam format Open Cybersecurity Schema Framework (OCSF), dan mengeluarkan data ke bucket Amazon Simple Storage Service (Amazon S3) atau aliran Amazon Data Firehose.
**Topics**
+ [AppFabric dukungan untuk GitHub](#github-appfabric-support)
+ [Menghubungkan AppFabric ke GitHub akun Anda](#github-appfabric-connecting)
## AppFabric dukungan untuk GitHub
AppFabric mendukung penerimaan informasi pengguna dan log audit dariGitHub.
### Prasyarat
Untuk digunakan AppFabric untuk mentransfer log audit dari GitHub tujuan yang didukung, Anda harus memenuhi persyaratan berikut:
+ Untuk mengakses log Audit, Anda harus memiliki akun perusahaan.
+ Untuk mengakses log audit Enterprise, Anda harus memiliki peran Administrator untuk akun perusahaan Anda.
+ Untuk mendapatkan log audit dari organisasi, Anda harus menjadi pemilik Organisasi.
### Pertimbangan batas tarif
GitHubmemberlakukan batas tarif pada GitHub API. Untuk informasi selengkapnya tentang batas tarif GitHub API, lihat Batas [dan Alokasi Permintaan API](https://docs.github.com/en/apps/creating-github-apps/registering-a-github-app/rate-limits-for-github-apps) di *GitHubsitus web*. Jika kombinasi AppFabric dan aplikasi GitHub API Anda yang ada melebihi GitHub’s batas, log audit yang muncul AppFabric mungkin tertunda.
### Pertimbangan keterlambatan data
Anda mungkin melihat penundaan hingga 30 menit untuk acara audit yang akan dikirim ke tujuan Anda. Hal ini disebabkan keterlambatan dalam peristiwa audit yang disediakan oleh aplikasi serta karena tindakan pencegahan yang diambil untuk mengurangi kehilangan data. Namun, ini mungkin dapat disesuaikan di tingkat akun. Untuk bantuan, hubungi [Dukungan](https://aws.amazon.com/contact-us/).
## Menghubungkan AppFabric ke GitHub akun Anda
Setelah Anda membuat app bundle dalam AppFabric layanan, Anda harus mengotorisasi AppFabric denganGitHub. Untuk menemukan informasi yang diperlukan untuk mengotorisasi GitHub AppFabric, gunakan langkah-langkah berikut.
### Buat OAuth aplikasi
AppFabric terintegrasi dengan GitHub penggunaan OAuth. Gunakan langkah-langkah berikut untuk membuat OAuth aplikasi diGitHub. Untuk informasi selengkapnya, lihat [Membuat GitHubs Aplikasi](https://docs.github.com/en/apps/creating-github-apps) di *GitHubsitus web*.
1. Pilih foto profil Anda yang terletak di sudut kanan atas halaman, lalu pilih **Pengaturan**.
1. Pilih **Pengaturan pengembang** di panel navigasi kiri.
1. Pilih **OAuth aplikasi** di panel navigasi kiri.
1. Pilih ** OAuth Aplikasi Baru**.
**catatan**
Tombol ini akan diberi label **Daftarkan aplikasi baru** jika Anda belum pernah membuat OAuth aplikasi sebelumnya.
1. Masukkan nama aplikasi Anda di kotak teks **Nama aplikasi**.
1. Masukkan URL contoh aplikasi lengkap di kotak teks **URL Beranda**.
1. (Opsional) Masukkan deskripsi untuk aplikasi Anda di kotak teks **Deskripsi aplikasi**. Pengguna akan melihat deskripsi ini.
1. Masukkan URL dengan format berikut di kotak teks **URL panggilan balik Otorisasi**.
```
https://.console.aws.amazon.com/appfabric/oauth2
```
Di URL ini, ** adalah kode Wilayah AWS tempat Anda mengonfigurasi bundel AppFabric aplikasi. Misalnya, kode untuk Wilayah AS Timur (Virginia N.) adalah`us-east-1`. Untuk Wilayah itu, URL pengalihan adalah`https://us-east-1.console.aws.amazon.com/appfabric/oauth2`.
1. Pilih **Aktifkan Alur Perangkat** jika OAuth aplikasi Anda akan menggunakan alur perangkat untuk mengidentifikasi dan mengotorisasi pengguna. Untuk informasi selengkapnya tentang alur perangkat, lihat [Mengotorisasi OAuth aplikasi](https://docs.github.com/en/enterprise-cloud@latest/apps/oauth-apps/building-oauth-apps/authorizing-oauth-apps#device-flow) di *GitHubsitus web*.
1. Pilih **Daftar aplikasi**.
### Otorisasi aplikasi
#### ID Penyewa
AppFabric akan meminta ID penyewa Anda. ID penyewa harus disediakan dalam salah satu format berikut:
**Log audit perusahaan:**
Gunakan log audit perusahaan jika Anda ingin mengetahui tindakan gabungan dari semua organisasi yang dimiliki oleh akun perusahaan Anda.
Untuk menggunakan log audit perusahaan, ID penyewa adalah ID perusahaan akun Anda. Anda dapat menemukan ID perusahaan Anda di bilah alamat browser Anda. Misalnya, `exampleenterprise` adalah ID perusahaan di URL berikut`https://github.com/settings/enterprises/examplenterprise`.
Saat Anda menentukan ID penyewa untuk log audit perusahaan, Anda harus mengawalinya dengan. `enterprise:` Oleh karena itu, tentukan contoh sebelumnya sebagai`enterprise:examplenterprise`.
**Log audit organisasi:**
Gunakan log audit organisasi sebagai admin organisasi jika Anda ingin mengetahui tindakan yang dilakukan oleh anggota organisasi Anda. Ini mencakup rincian seperti siapa yang melakukan tindakan, apa tindakan itu, dan kapan itu dilakukan.
Untuk menggunakan log audit organisasi, ID penyewa adalah ID organisasi Anda. Anda dapat menemukan ID organisasi Anda di bilah alamat browser Anda. Misalnya, `exampleorganization` adalah ID organisasi di URL berikut`https://github.com/settings/organizations/exampleorganization`.
Saat Anda menentukan ID penyewa untuk log audit organisasi, Anda harus mengawalinya dengan. `organization:` Oleh karena itu, tentukan contoh sebelumnya sebagai`organization:exampleorganization`.
#### Nama penyewa
Masukkan nama yang mengidentifikasi GitHub perusahaan atau organisasi unik ini. AppFabric menggunakan nama penyewa untuk memberi label pada otorisasi aplikasi dan konsumsi apa pun yang dibuat dari otorisasi aplikasi.
#### ID Klien
AppFabric akan meminta ID klien. Gunakan langkah-langkah berikut untuk menemukan ID klien Anda diGitHub,
1. Pilih foto profil Anda yang terletak di sudut kanan atas halaman, lalu pilih **Pengaturan**.
1. Pilih **Pengaturan pengembang** di panel navigasi kiri.
1. Pilih **OAuth aplikasi** di panel navigasi kiri.
1. Pilih OAuth aplikasi tertentu, lalu cari nilai **Client ID**.
#### Rahasia klien
AppFabric akan meminta rahasia klien. Gunakan langkah-langkah berikut untuk menemukan rahasia klien AndaGitHub.
1. Pilih foto profil Anda yang terletak di sudut kanan atas halaman, lalu pilih **Pengaturan**.
1. Pilih **Pengaturan pengembang** di panel navigasi kiri.
1. Pilih **OAuth aplikasi** di panel navigasi kiri.
1. Pilih OAuth aplikasi tertentu, lalu cari nilai **Rahasia Klien**. Jika Anda tidak dapat menemukan rahasia klien yang ada, maka Anda mungkin perlu membuat yang baru.
#### Menyetujui otorisasi
Setelah membuat otorisasi aplikasi di AppFabric, Anda akan menerima jendela pop-up dari GitHub untuk menyetujui otorisasi. **Untuk menyetujui AppFabric otorisasi, pilih Izinkan.**
Pastikan organisasi Anda telah [memberikan akses](https://docs.github.com/en/organizations/managing-oauth-access-to-your-organizations-data/approving-oauth-apps-for-your-organization) ke OAuth aplikasi, jika [pembatasan akses OAuth Aplikasi](https://docs.github.com/en/organizations/managing-oauth-access-to-your-organizations-data/about-oauth-app-access-restrictions) diaktifkan.