# Autentikasi

Perpustakaan `huggingface_hub` memungkinkan pengguna untuk mengelola autentikasi ke Hub secara programatik. Ini mencakup masuk, keluar, beralih antar token, dan menampilkan daftar token yang tersedia.

Untuk detail lebih lanjut tentang autentikasi, lihat [bagian ini](../quick-start#authentication).

## login[[huggingface_hub.login]]

#### huggingface_hub.login[[huggingface_hub.login]]

```python
huggingface_hub.login(token: str | None = None, add_to_git_credential: bool = False, skip_if_logged_in: bool = True)
```

[Sumber](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_login.py#L57)

**Parameter:**

token (`str`, *opsional*) : Token akses pengguna untuk dibuat dari https://huggingface.co/settings/token.

add_to_git_credential (`bool`, defaultnya `False`) : Jika `True`, token akan diset sebagai kredensial git. Jika tidak ada helper kredensial git yang dikonfigurasi, peringatan akan ditampilkan kepada pengguna. Hanya digunakan ketika `token` disediakan; diabaikan oleh alur berbasis browser.

skip_if_logged_in (`bool`, defaultnya `True`) : Jika `True`, jangan minta token jika pengguna sudah masuk. Atur ke `False` untuk memaksa masuk ulang. Di CLI, gunakan `--force` sebagai gantinya.

**Mengangkat:** ``ValueError`` atau `DeviceCodeError`

- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- Jika token organisasi yang diberikan. Hanya token akun pribadi yang valid untuk masuk.
- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- Jika token tidak valid.
- `DeviceCodeError` -- Jika login berbasis browser gagal (otorisasi ditolak, kode kedaluwarsa, ...).

Login ke mesin untuk mengakses Hub.

`token` disimpan di cache dan diset sebagai kredensial git. Setelah selesai, mesin akan masuk dan token akses akan tersedia di semua komponen `huggingface_hub`. Jika `token` tidak diberikan, alur OAuth berbasis browser digunakan untuk autentikasi: buka URL, masukkan kode pendek, lalu token diambil dan disimpan. Di terminal, Anda juga dapat memilih untuk menempelkan token akses yang sudah ada.

Untuk masuk dari luar skrip, Anda juga dapat menggunakan `hf auth login`, yaitu perintah cli yang membungkus [login()](/docs/huggingface_hub/v2.4.0/id/package_reference/authentication#huggingface_hub.login).

> [!TIP]
> Ketika token tidak diteruskan, [login()](/docs/huggingface_hub/v2.4.0/id/package_reference/authentication#huggingface_hub.login) akan secara otomatis mendeteksi apakah skrip dijalankan di notebook atau tidak. Namun, deteksi ini mungkin tidak akurat karena beragamnya notebook yang ada saat ini. Jika demikian, Anda selalu dapat memaksa penggunaan UI dengan menggunakan [notebook_login()](/docs/huggingface_hub/v2.4.0/id/package_reference/authentication#huggingface_hub.notebook_login) atau [interpreter_login()](/docs/huggingface_hub/v2.4.0/id/package_reference/authentication#huggingface_hub.interpreter_login).

## interpreter_login[[huggingface_hub.interpreter_login]]

#### huggingface_hub.interpreter_login[[huggingface_hub.interpreter_login]]

```python
huggingface_hub.interpreter_login(skip_if_logged_in: bool = True)
```

[Sumber](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_login.py#L284)

**Parameter:**

skip_if_logged_in (`bool`, defaultnya `True`) : Jika `True`, jangan minta token jika pengguna sudah masuk. Atur ke `False` untuk memaksa masuk ulang. Di CLI, gunakan `--force` sebagai gantinya.

Menampilkan prompt untuk masuk ke situs web HF dan menyimpan token.

Ini setara dengan [login()](/docs/huggingface_hub/v2.4.0/id/package_reference/authentication#huggingface_hub.login) tanpa meneruskan token ketika tidak dijalankan di notebook. [interpreter_login()](/docs/huggingface_hub/v2.4.0/id/package_reference/authentication#huggingface_hub.interpreter_login) berguna jika Anda ingin memaksa penggunaan prompt terminal alih-alih alur notebook.

Untuk detail lebih lanjut, lihat [login()](/docs/huggingface_hub/v2.4.0/id/package_reference/authentication#huggingface_hub.login).

## notebook_login[[huggingface_hub.notebook_login]]

#### huggingface_hub.notebook_login[[huggingface_hub.notebook_login]]

```python
huggingface_hub.notebook_login(skip_if_logged_in: bool = True)
```

[Sumber](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_login.py#L335)

**Parameter:**

skip_if_logged_in (`bool`, defaultnya `True`) : Jika `True`, jangan minta token jika pengguna sudah masuk. Atur ke `False` untuk memaksa masuk ulang. Di CLI, gunakan `--force` sebagai gantinya.

Menampilkan prompt untuk masuk ke situs web HF dan menyimpan token.

Ini setara dengan [login()](/docs/huggingface_hub/v2.4.0/id/package_reference/authentication#huggingface_hub.login) tanpa meneruskan token saat dijalankan di notebook. [notebook_login()](/docs/huggingface_hub/v2.4.0/id/package_reference/authentication#huggingface_hub.notebook_login) berguna jika Anda ingin memaksa penggunaan alur notebook alih-alih prompt di terminal.

Untuk detail lebih lanjut, lihat [login()](/docs/huggingface_hub/v2.4.0/id/package_reference/authentication#huggingface_hub.login).

## logout[[huggingface_hub.logout]]

#### huggingface_hub.logout[[huggingface_hub.logout]]

```python
huggingface_hub.logout(token_name: str | None = None)
```

[Sumber](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_login.py#L120)

**Parameter:**

token_name (`str`, *opsional*) : Nama token akses untuk keluar. Jika `None`, akan keluar dari semua token akses yang tersimpan.

**Mengangkat:** ``ValueError``

- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- Jika nama access token tidak ditemukan.

Logout mesin dari Hub.

Token dihapus dari mesin dan dihapus dari kredensial git.

## auth_switch[[huggingface_hub.auth_switch]]

#### huggingface_hub.auth_switch[[huggingface_hub.auth_switch]]

```python
huggingface_hub.auth_switch(token_name: str, add_to_git_credential: bool = False)
```

[Sumber](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_login.py#L162)

**Parameter:**

token_name (`str`) : Nama token akses untuk beralih ke.

add_to_git_credential (`bool`, defaultnya `False`) : Jika `True`, token akan diset sebagai kredensial git. Jika tidak ada helper kredensial git yang dikonfigurasi, peringatan akan ditampilkan kepada pengguna. Jika `token` adalah `None`, nilai dari `add_to_git_credential` diabaikan dan akan diminta kembali kepada pengguna akhir.

**Mengangkat:** ``ValueError``

- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- Jika nama access token tidak ditemukan.

Beralih ke token akses yang berbeda.

## auth_list[[huggingface_hub.auth_list]]

#### huggingface_hub.auth_list[[huggingface_hub.auth_list]]

```python
huggingface_hub.auth_list()
```

[Sumber](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_login.py#L191)

Daftarkan semua token akses yang disimpan.