# Kimlik Doğrulama

`huggingface_hub` kütüphanesi, kullanıcıların Hub'a kimlik doğrulamasını programatik olarak yönetmesine olanak tanır. Bu, oturum açma, oturumu kapatma, jetonlar arasında geçiş yapma ve kullanılabilir jetonları listeleme işlemlerini içerir.

Kimlik doğrulama hakkında daha fazla ayrıntı için [bu bölümü](../quick-start#authentication) inceleyin.

## giriş yap[[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)
```

[Kaynak](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_login.py#L57)

**Parametreler:**

token (`str`, *isteğe bağlı*) : https://huggingface.co/settings/token adresinden oluşturulacak kullanıcı erişim belirteci.

add_to_git_credential (`bool`, varsayılan `False`) : `True` ise, token git kimlik bilgisi olarak ayarlanır. Git kimlik bilgisi yardımcısı yapılandırılmamışsa, kullanıcıya bir uyarı görüntülenir. Yalnızca `token` sağlandığında kullanılır; tarayıcı tabanlı akış tarafından yok sayılır.

skip_if_logged_in (`bool`, varsayılan `True`) : `True` ise, kullanıcı zaten oturum açmışsa token için istek yapılmaz. Zorla yeniden oturum açmayı etkinleştirmek için `False` olarak ayarlayın. CLI'da bunun yerine `--force` kullanın.

**Yükselen:** ``ValueError`` veya `DeviceCodeError`

- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- Bir organizasyon jetonu geçirilirse. Giriş yapmak için yalnızca kişisel hesap jetonları geçerlidir.
- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- Token geçersizse.
- `DeviceCodeError` -- Tarayıcı tabanlı oturum açma işlemi başarısız olursa (yetkilendirme reddedildi, kodun süresi doldu, ...).

Hub'a erişmek için makineye giriş yapın.

`token`, önbellekte kalıcı olarak saklanır ve bir git kimlik bilgisi olarak ayarlanır. İşlem tamamlandığında makine oturum açmış olur ve erişim jetonu, `huggingface_hub` bileşenlerinin tümünde kullanılabilir hale gelir. `token` sağlanmazsa, kimlik doğrulama için tarayıcı tabanlı bir OAuth akışı kullanılır: bir URL açılır, kısa bir kod girilir ve jeton alınarak kaydedilir. Bir terminalde, bunun yerine mevcut bir erişim jetonunu yapıştırma seçeneğini de seçebilirsiniz.

Bir betiğin dışından oturum açmak için, [login()](/docs/huggingface_hub/main/tr/package_reference/authentication#huggingface_hub.login) fonksiyonunu saran bir komut satırı komutu olan `hf auth login` komutunu da kullanabilirsiniz.

> [!TIP]
> Token geçirilmediğinde, [login()](/docs/huggingface_hub/main/tr/package_reference/authentication#huggingface_hub.login) betiğin bir notebook'ta mı yoksa değil mi çalıştığını otomatik olarak algılar. Ancak günümüzde mevcut olan notebook çeşitliliği nedeniyle bu algılama her zaman doğru olmayabilir. Böyle bir durumda, arayüzü [notebook_login()](/docs/huggingface_hub/main/tr/package_reference/authentication#huggingface_hub.notebook_login) veya [interpreter_login()](/docs/huggingface_hub/main/tr/package_reference/authentication#huggingface_hub.interpreter_login) kullanarak her zaman zorlayabilirsiniz.

## 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)
```

[Kaynak](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_login.py#L284)

**Parametreler:**

skip_if_logged_in (`bool`, varsayılan `True`) : `True` ise, kullanıcı zaten oturum açmışsa token için istek yapılmaz. Zorla yeniden oturum açmayı etkinleştirmek için `False` olarak ayarlayın. CLI'da bunun yerine `--force` kullanın.

HF web sitesine giriş yapmayı ve belirteci saklamayı içeren bir istem görüntüler.

Bu, bir notebook dışında çalıştırıldığında token geçirilmeden [login()](/docs/huggingface_hub/main/tr/package_reference/authentication#huggingface_hub.login) çağrısına eşdeğerdir. [interpreter_login()](/docs/huggingface_hub/main/tr/package_reference/authentication#huggingface_hub.interpreter_login), notebook akışı yerine terminal istemcisinin kullanımını zorlamak istediğinizde kullanışlıdır.

Daha fazla ayrıntı için [login()](/docs/huggingface_hub/main/tr/package_reference/authentication#huggingface_hub.login) bölümüne bakın.

## 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)
```

[Kaynak](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_login.py#L335)

**Parametreler:**

skip_if_logged_in (`bool`, varsayılan `True`) : `True` ise, kullanıcı zaten oturum açmışsa token için istek yapılmaz. Zorla yeniden oturum açmayı etkinleştirmek için `False` olarak ayarlayın. CLI'da bunun yerine `--force` kullanın.

HF web sitesine giriş yapmayı ve belirteci saklamayı içeren bir istem görüntüler.

Bu, bir notebook'ta çalıştırıldığında token geçirilmeden [login()](/docs/huggingface_hub/main/tr/package_reference/authentication#huggingface_hub.login) çağrısına eşdeğerdir. Terminalde bir istek yerine notebook akışının kullanılmasını zorlamak istiyorsanız [notebook_login()](/docs/huggingface_hub/main/tr/package_reference/authentication#huggingface_hub.notebook_login) kullanışlıdır.

Daha fazla ayrıntı için [login()](/docs/huggingface_hub/main/tr/package_reference/authentication#huggingface_hub.login) bölümüne bakın.

## oturumu kapat[[huggingface_hub.logout]]

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

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

[Kaynak](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_login.py#L120)

**Parametreler:**

token_name (`str`, *isteğe bağlı*) : Çıkış yapılmak istenen erişim jetonunun adı. `None` ise, kayıtlı tüm erişim jetonlarından çıkış yapılır.

**Yükselen:** ``ValueError``

- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- Erişim jetonu adı bulunamazsa.

Makineyi Hub'dan çıkış yapın.

Token makineden silinir ve git kimlik bilgisi (credential) üzerinden kaldırılır.

## 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)
```

[Kaynak](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_login.py#L162)

**Parametreler:**

token_name (`str`) : Geçilecek erişim jetonunun adı.

add_to_git_credential (`bool`, varsayılan `False`) : `True` ise, token git kimlik bilgisi olarak ayarlanır. Git kimlik bilgisi yardımcısı yapılandırılmamışsa, kullanıcıya bir uyarı görüntülenir. `token` `None` ise, `add_to_git_credential` değeri yok sayılır ve nihai kullanıcıdan yeniden istenir.

**Yükselen:** ``ValueError``

- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- Erişim jetonu adı bulunamazsa.

Farklı bir erişim belirteçine geçin.

## auth_list[[huggingface_hub.auth_list]]

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

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

[Kaynak](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_login.py#L191)

Tüm depolanan erişim jetonlarını listeler.