# Cara mengonfigurasi SAML SSO dengan Google Workspace

Dalam panduan ini, kami akan menggunakan Google Workspace sebagai penyedia SSO dan protokol Security Assertion Markup Language (SAML) sebagai protokol identitas yang kami pilih.

Saat ini, kami mendukung autentikasi yang diinisiasi oleh SP dan autentikasi yang diinisiasi oleh IdP. Untuk provisioning pengguna, lihat [SCIM](./enterprise-scim).

> [!WARNING]
> Fitur ini merupakan bagian dari paket Team & Enterprise.

## Langkah 1: Buat Aplikasi SAML di Google Workspace

- Di konsol admin Google Workspace Anda, navigasikan ke `Admin` > `Apps` > `Web and mobile apps`.
- Klik `Add app` lalu `Add custom SAML app`.
- Anda harus memberikan nama untuk aplikasi Anda di bidang "App name".
- Klik `Continue`.

## Langkah 2: Konfigurasikan Hugging Face dengan Detail IdP Google

- Layar berikutnya dalam pengaturan Google berisi informasi SSO untuk aplikasi Anda.
- Di pengaturan organisasi Hugging Face Anda, buka tab `SSO` dan pilih protokol `SAML`.
- Salin **SSO URL** dari Google ke kolom **Sign-on URL** di Hugging Face.
- Salin **Certificate** dari Google ke kolom yang sesuai di Hugging Face. Sertifikat publik harus memiliki format berikut:
  ```
  -----BEGIN CERTIFICATE-----
  {certificate}
  -----END CERTIFICATE-----
  ```

- Dalam pengaturan Google Workspace, klik `Continue`.

## Langkah 3: Konfigurasikan Google dengan Detail SP Hugging Face

- Pada layar "Service provider details", Anda memerlukan `Assertion Consumer Service URL` dan `SP Entity ID` dari pengaturan SSO Hugging Face Anda. Salin keduanya ke kolom `ACS URL` dan `Entity ID` yang sesuai di Google.
- Pastikan hal-hal berikut telah diatur:
    - Centang kotak **Respons bertanda tangan**.
    - Format ID Nama: `EMAIL`
    - ID Nama: `Basic Information > Primary email`

- Klik `Continue`.

## Langkah 4: Pemetaan Atribut

- Pada layar "Attribute mapping", klik `Add mapping` dan konfigurasikan atribut yang ingin Anda kirimkan. Langkah ini bersifat opsional dan bergantung pada apakah Anda ingin menggunakan [Role Mapping](./security-sso-user-management#role-mapping) atau [Resource Group Mapping](./security-sso-user-management#resource-group-mapping) di Hugging Face.

- Klik `Finish`.

## Langkah 5: Uji dan Aktifkan SSO

> [!WARNING]
> Sebelum pengujian, pastikan Anda telah memberikan akses ke aplikasi untuk pengguna yang sesuai di konsol admin Google Workspace di bawah pengaturan "User access" aplikasi. Admin yang melakukan pengujian harus memiliki akses. Perubahan akses pengguna mungkin memerlukan beberapa menit untuk diterapkan di Google Workspace.

- Sekarang, di pengaturan SSO Hugging Face Anda, klik **"Update and Test SAML configuration"**.
- Anda akan diarahkan ke prompt login Google. Setelah masuk, Anda akan diarahkan ke halaman pengaturan organisasi Anda.
- Tanda centang hijau di dekat pemilih SAML akan mengonfirmasi bahwa pengujian berhasil.
- Setelah pengujian berhasil, Anda dapat mengaktifkan SSO untuk organisasi Anda dengan mengklik tombol "Enable".
- Setelah diaktifkan, anggota organisasi Anda harus menyelesaikan alur autentikasi SSO yang dijelaskan dalam bagian [Cara kerjanya](./security-sso-basic#how-it-works).