Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Buat portal di API Gateway
Portal adalah kumpulan produk. Anda mengontrol otorisasi, branding, dan publikasi portal Anda. Saat Anda membuat portal, status publikasikannya adalah`Disabled`. Ini berarti portal Anda tidak dapat ditemukan di web. Untuk memungkinkan konsumen mengakses portal Anda, Anda perlu mempublikasikannya. Sebelum Anda mempublikasikan portal Anda, Anda juga dapat melihat pratinjaunya.
API Gateway mendukung portal pada browser berikut:
+ Firefox
+ Google Chrome
+ Microsoft Edge
+ Safari
## Pilih nama domain
Secara default, URL portal Anda di-host di nama domain milik Amazon berikut:
```
https://p-{{portalId}}.apigw-portal.{{us-east-1}}.on.aws
```
Untuk menyesuaikan nama domain, Anda dapat memberikan nama domain yang Anda miliki dan sertifikat SSL untuk domain kustom. Sertifikat harus dikelola dengan [AWS Certificate Manager](https://docs.aws.amazon.com/acm/latest/userguide/)(ACM) di AS Timur (Virginia N.) dan didukung oleh Amazon. CloudFront Untuk informasi selengkapnya, lihat [Persyaratan untuk menggunakan SSL/TLS sertifikat dengan CloudFront](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/cnames-and-https-requirements.html).
Saat Anda menggunakan nama domain khusus, API Gateway membuat CloudFront distribusi, diamankan saat transit dengan sertifikat ACM Anda. Kemudian, API Gateway menyediakan catatan alias, yang Anda tambahkan ke konfigurasi DNS Anda. Catatan alias adalah nama domain milik Amazon. Anda harus menambahkan catatan alias ini untuk mengarahkan lalu lintas ke CloudFront distribusi untuk domain kustom Anda. Nama domain yang Anda berikan harus unik dan belum digunakan oleh daftar alias pada CloudFront distribusi yang ada.
Jika Anda menggunakan nama domain Anda sendiri, API Gateway menggunakan kebijakan `TLS_1_2` keamanan untuk melindungi portal Anda. Untuk informasi selengkapnya, lihat [Protokol dan sandi yang didukung](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/secure-connections-supported-viewer-protocols-ciphers.html) antar pemirsa. Anda tidak dapat mengubah nilai ini.
## Buat portal
Anda menggunakan konsol API Gateway untuk membuat dan mengonfigurasi portal Anda. Prosedur berikut memandu Anda melalui semua langkah yang diperlukan. Anda juga dapat memilih **Skip to Review dan membuat** di akhir prosedur pertama untuk membuat portal kosong.
Prosedur berikut menunjukkan cara membuat portal. Pertama, Anda menentukan detail portal Anda.
**Untuk menentukan detail portal Anda**
1. Masuk ke konsol API Gateway di [https://console.aws.amazon.com/apigateway](https://console.aws.amazon.com/apigateway).
1. Di panel navigasi utama, pilih **Portal**.
1. Pilih **Buat portal**.
1. Di bawah detail portal, untuk **nama Portal**, masukkan nama.
1. Untuk **deskripsi Portal**, masukkan deskripsi.
1. Untuk **otorisasi Portal**, pilih cara mengotorisasi portal Anda.
+ Jika ini adalah pertama kalinya Anda membuat portal, kami sarankan Anda memilih **None**. Jika Anda berencana menambahkan produksi apa pun APIs ke portal Anda, gunakan **Memerlukan otorisasi**.
+ Untuk mengharuskan konsumen portal mengautentikasi untuk menggunakan portal Anda, pilih **Memerlukan otorisasi**, dan lakukan hal berikut:
1. Untuk kumpulan pengguna **Amazon Cognito, pilih kumpulan pengguna** Anda.
Kumpulan pengguna harus berada di Wilayah yang sama dengan portal Anda.
1. Untuk **ID klien Aplikasi**, pilih ID klien aplikasi.
Di klien aplikasi, Anda harus menyetel URL callback ke URL default portal.
1. Untuk **domain kumpulan pengguna**, masukkan domain kumpulan pengguna. Untuk informasi selengkapnya, lihat [Mengonfigurasi domain kumpulan pengguna](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-assign-domain.html).
1. Untuk **konfigurasi Domain**, pilih nama domain untuk portal Anda.
+ Jika ini adalah pertama kalinya Anda membuat portal, kami sarankan Anda memilih **Domain default**. Setelah Anda mempublikasikan portal Anda, itu akan tersedia di`https://p-{{portalId}}.apigw-portal.{{us-east-1}}.on.aws`.
+ Untuk memberikan nama domain kustom yang Anda miliki, pilih **Custom domain name** dan lakukan hal berikut:
1. Untuk **nama Domain**, masukkan nama domain yang sepenuhnya memenuhi syarat.
1. Untuk **sertifikat ACM**, pilih sertifikat ACM yang mencakup nama domain.
Anda harus menambahkan catatan alias yang disediakan API Gateway ke catatan DNS Anda, untuk melayani lalu lintas dari portal Anda.
1. Untuk menambahkan monitor aplikasi CloudWatch RUM ke portal Anda, untuk **monitor aplikasi RUM**, pilih monitor aplikasi. Untuk informasi lebih lanjut, lihat [CloudWatch RUM](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-RUM.html).
1. Pilih **Berikutnya**.
Setelah Anda menentukan detail portal Anda, Anda menambahkan produk portal. Anda dapat mengubah produk portal di portal Anda kapan saja, tetapi Anda perlu mempublikasikan ulang portal Anda agar perubahan diterapkan.
**Untuk memilih produk portal Anda**
1. Dari daftar sumber daya, pilih produk yang akan ditambahkan ke portal Anda.
1. Pilih **Berikutnya**.
Setelah Anda memilih produk Anda, Anda menyesuaikan desain portal. Untuk mengunggah logo portal, Anda harus memiliki gambar yang diunggah ke Amazon S3. Anda dapat mengubah nilai-nilai ini kapan saja, tetapi Anda perlu mempublikasikan ulang portal Anda agar perubahan diterapkan.
**(Opsional) Untuk menyesuaikan portal Anda**
1. Untuk **logo Portal**, berikan URI S3 untuk file Anda.
Hanya`.svg`,`.png`, atau `.jpg` didukung.
1. Untuk menyesuaikan desain portal Anda, Anda memiliki dua opsi:
1. Anda dapat memilih **tema Portal** untuk menerapkan tema warna pra-dibuat di portal Anda.
1. Anda dapat menggunakan pemilih warna untuk memilih semua opsi desain portal Anda.
1. Pilih **Berikutnya**.
Setelah Anda memilih desain portal, tinjau informasi untuk portal.
**Untuk meninjau portal Anda**
+ Tinjau pengaturan Anda di halaman ulasan dan buat. Setelah Anda puas dengan pengaturan, pilih **Buat**.
Jika Anda menggunakan kumpulan pengguna Amazon Cognito untuk mengontrol akses ke portal, Anda harus menyetel URL panggilan balik ke URL default portal di klien aplikasi. Untuk informasi selengkapnya, lihat [Pengaturan khusus aplikasi dengan klien aplikasi](https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-settings-client-apps.html).
Portal Anda tidak akan tersedia untuk konsumen setelah Anda membuatnya. Anda harus mempublikasikan portal Anda agar dapat diakses di internet. Lihat informasi yang lebih lengkap di [Publikasikan portal di API Gateway](apigateway-portals-publish-portal.md).