# İki adımlı doğrulama

> Paroladan sonra bir doğrulama uygulamasından kod isteyin. Kişiler nasıl açar, yöneticiler nasıl sıfırlar ve zorunlu kılar.

Kaynak: https://proxus.io/tr/docs/administer/two-step-verification

Bu rehberin sonunda parolayla girişte, kişinin telefonundaki bir doğrulama uygulamasından 6 haneli bir kod da
istenir. Çalınan bir parola tek başına artık Proxus'u açmaz; ne tarayıcıda ne de REST API üzerinden.

İki adımlı doğrulama, Proxus giriş sayfasına parola yazan kişiler içindir: Proxus parolasıyla ya da
[Active Directory veya LDAP](https://proxus.io/tr/docs/administer/active-directory) parolasıyla girenler. Kimlik sağlayıcınız üzerinden
([tek oturum açma](https://proxus.io/tr/docs/administer/single-sign-on)) girenler ikinci adımı sağlayıcıdan alır.

## Başlamadan önce

- Telefonunuzda bir doğrulama uygulaması: Microsoft Authenticator, Google Authenticator, Authy ya da bir parola
  yöneticisinin tek kullanımlık kodları (1Password, Bitwarden ve diğerleri).
- Telefonun saati otomatik ayarlı olmalı. Kodlar her 30 saniyede değişir.

## Açın

1. Sağ üstteki hesap menünüzü açın ve **Bilgilerim**'i seçin.
2. **İki adımlı doğrulamayı kur**'u seçin.

*Ekran görüntüsü: QR kodu, Doğrulama kodu alanı ve Aç düğmesi işaretli İki adımlı doğrulamayı kur penceresi*

3. Uygulamada bir hesap ekleyin ve QR kodu (1) okutun. Okutamıyorsanız altında gösterilen anahtarı girin.
4. Uygulamanın gösterdiği 6 haneli kodu **Doğrulama kodu** alanına (2) girin ve **Aç**'ı (3) seçin.
5. Proxus on **kurtarma kodu** (1) gösterir. Bunları telefondan ayrı, güvenli bir yerde saklayın ve **Kodları
   kaydettim**'i (2) seçin. Yalnızca bu bir kez gösterilirler.

*Ekran görüntüsü: On kodun listesi ve Kodları kaydettim düğmesi işaretli kurtarma kodları penceresi*

Bir sonraki girişten itibaren, kullanıcı adı ve paroladan sonra Proxus **Doğrulama kodu**'nu (1) sorar. Uygulamanın
gösterdiği kodu parolanızla birlikte girin ve **Oturum aç**'ı seçin.

*Ekran görüntüsü: Kullanıcı adı ve parolanın altında Doğrulama kodu alanı işaretli giriş formu*

## Telefonunuz olmadan giriş yapın

**Doğrulama kodu** alanına bunun yerine kurtarma kodlarınızdan birini girin. Her kurtarma kodu bir kez çalışır.
Bir kısmını kullandıysanız yenilerini oluşturun: **Bilgilerim** > **Yeni kurtarma kodları** (uygulamadan bir kod
ister); eskiler artık çalışmaz.

## Kapatın

**Bilgilerim** > **İki adımlı doğrulamayı kapat**, ardından uygulamadan bir kodu ya da bir kurtarma kodunu girin.

## Telefonunu ve kodlarını kaybeden birine yardım edin

Bir yönetici ya da kullanıcıları değiştirebilen biri:

1. **Güvenlik > Kullanıcılar**'ı açın ve kişinin kullanıcısını açın.
2. **İki adımlı doğrulamayı sıfırla**'yı (1) seçin ve onaylayın.

*Ekran görüntüsü: Araç çubuğunda İki adımlı doğrulamayı sıfırla düğmesi işaretli kullanıcı sayfası*

Kişi yalnızca parolasıyla girer ve iki adımlı doğrulamayı **Bilgilerim**'de yeniden kurar.

## Yöneticiler için zorunlu kılın

Parolayla giren her yöneticinin iki adımlı doğrulama kullanması için `Proxus-config.toml` içinde şunu ayarlayın:

```toml
[Security.TwoStep]
RequiredForAdministrators = true
```

Hub'ı yeniden başlatın. Kurmamış bir yöneticiden girişin hemen ardından kurması istenir; kurmadan devam edemez.
**Administrators** rolüne ya da **Is Administrative** işaretli herhangi bir role sahip kullanıcılar yönetici
sayılır. Bkz. [Yapılandırma anahtarları](https://proxus.io/tr/docs/reference/configuration#securitytwostep).

## Programlar ve REST API

Kullanıcı adı ve parolayla token alan bir program, o kullanıcı için iki adımlı doğrulama açıksa güncel kodu `code`
olarak göndermelidir:

```bash
curl -X POST https://proxus.example.com/api/Authentication/Authenticate \
  -H "Content-Type: application/json" \
  -d '{"userName":"maria","password":"...","code":"123456"}'
```

Kod olmadan yanıt, kodu isteyen bir mesajla `401` olur. Bir kişi olmadan çalışan programlar için
[kimlik sağlayıcınızın bir servis hesabını](https://proxus.io/tr/docs/administer/single-sign-on#api-mcp-ve-servis-hesapları) ya da
iki adımlı doğrulaması olmayan ve rolü yalnızca programın ihtiyacına izin veren bir kullanıcıyı kullanın.

## Nasıl korunur

- Her kod bir kez kabul edilir. İkinci kez girilen bir kod, kişi de program da olsa reddedilir.
- Yanlış kod başarısız giriş sayılır; [hesap kilitleme](https://proxus.io/tr/docs/administer/users-and-roles) uygulanır.
- Uygulamanın kullandığı anahtar, [Sertifika deposu](https://proxus.io/tr/docs/administer/certificates) ile aynı anahtarla şifreli
  saklanır. Yapılandırma klasörünü yedekleyin: o anahtar olmadan iki adımlı doğrulamanın yeniden kurulması gerekir.
- Kurtarma kodları, parolalar gibi yalnızca hash olarak saklanır.

## Bir şey çalışmadığında

| Ne görüyorsunuz | Neden | Ne yapmalı |
| --- | --- | --- |
| Güncel kodla "Kod doğru değil". | Telefonun saati 30 saniyeden fazla sapmış. | Telefonun saatini otomatik yapın, ardından bir sonraki kodu deneyin. |
| Kod az önce doğruydu. | Her kod bir kez kabul edilir. | Uygulamadaki bir sonraki kodu bekleyin. |
| Yanlış kodlardan sonra hesap kilitlendi. | Yanlış kodlar başarısız giriş sayılır. | Kilidin bitmesini bekleyin ya da bir yöneticiye başvurun. |
| Telefon kayıp ve kurtarma kodu yok. | | Bir yöneticiden iki adımlı doğrulamayı sıfırlamasını isteyin. |

## Sırada ne var

- [Kullanıcılar ve roller](https://proxus.io/tr/docs/administer/users-and-roles)
- [Tek oturum açma](https://proxus.io/tr/docs/administer/single-sign-on)
- [Güvenlik](https://proxus.io/tr/docs/operate/security): sıkılaştırma kontrol listesi
