# Tek oturum açmayı (SSO) kurma

> Enterprise planında AI CodeOps için SAML 2.0 veya OpenID Connect girişini kurun: alan adınızı doğrulayın, bir bağlantı oluşturun, IdP'nizi yapılandırın ve etkinleştirin.

Kaynak: https://aicodeops.dev/tr/docs/sso · Son güncelleme: 2026-10-18

Tek oturum açma, çalışanlarınızın AI CodeOps'a kendi kimlik sağlayıcınız (IdP) üzerinden, SAML 2.0 veya OpenID Connect (OIDC) ile giriş yapmasını sağlar. Bu protokollerden birini destekleyen her IdP çalışır; bilgilerini kendiniz girersiniz, dolayısıyla hazır sağlayıcı ayarları yoktur.

## Başlamadan önce

- **Plan.** SSO, Enterprise planının parçasıdır; alan adı doğrulaması da öyle. Plan yoksa kart "SSO (SAML 2.0 / OIDC) is available on the Enterprise plan." mesajını gösterir. Bkz. [Enterprise](https://aicodeops.dev/tr/enterprise).
- **Kim kurabilir.** SSO tek bir çalışma alanına değil, kuruluşa aittir. Kartı kuruluşun Owner ve Admin rolleri görür. Bir bağlantıyı yalnızca bir Owner oluşturabilir, düzenleyebilir ve etkinleştirebilir. Owner ve Admin rolleri alan adlarını doğrulayabilir, SSO varsayılan çalışma alanını belirleyebilir ve bağlantıları devre dışı bırakıp silebilir.
- **DNS erişimi.** E-posta alan adınız için bir TXT kaydı eklemeniz gerekir.

Ayarlar **Configure → Settings** sayfasında, **Single sign-on** kartındadır.

## 1. Alan adınızı doğrulayın

1. **Verified Domains** altında e-posta alan adınızı girin (örneğin `example.com`) ve **Verify a domain** düğmesini seçin.
2. Gösterilen TXT kaydını DNS'inize ekleyin:
   - Name: `_codeopsstudio-verify.example.com`
   - Value: ekrandaki token
3. **Check now** düğmesini seçin. DNS değişikliklerinin görünmesi zaman alabilir; henüz doğrulanmadıysa daha sonra yeniden kontrol edin.

Bir alan adı doğrulanana kadar onun için bağlantı oluşturamazsınız.

## 2. Bir bağlantı oluşturun

1. **Add SSO connection** düğmesini seçin.
2. **New SSO Connection** formunda şunları doldurun:

| Alan             | SAML 2.0                                                      | OpenID Connect                                   |
| ---------------- | ------------------------------------------------------------- | ------------------------------------------------ |
| **Protocol**     | SAML 2.0                                                      | OpenID Connect                                   |
| **Display Name** | "Okta" gibi tanıdığınız bir ad                                | "Azure AD" gibi bir ad                           |
| **Email Domain** | Doğrulanmış bir alan adı                                      | Doğrulanmış bir alan adı                         |
| **Default Role** | Member, Developer veya Viewer                                 | Member, Developer veya Viewer                    |
| IdP bilgileri    | **IdP Entity ID**, **IdP SSO URL**, **IdP Certificate (PEM)** | **Issuer URL**, **Client ID**, **Client Secret** |

3. **Create Connection** düğmesini seçin.

OIDC client secret depolanırken şifrelenir. IdP metadata URL'si için bir alan yoktur; değerleri IdP'nizden kopyalayın.

## 3. Kimlik sağlayıcınızı yapılandırın

Bağlantı kartı, IdP'nizin ihtiyaç duyduğu değerleri gösterir:

| Protokol | Etiket           | Yol                                  | Kullanım                                     |
| -------- | ---------------- | ------------------------------------ | -------------------------------------------- |
| SAML     | **Metadata URL** | `/sso/saml/<connection-id>/metadata` | Service provider metadata'sı ve entity ID'si |
| SAML     | **ACS URL**      | `/sso/saml/<connection-id>/acs`      | Assertion Consumer Service (HTTP-POST)       |
| OIDC     | **Redirect URI** | `/sso/oidc/<connection-id>/callback` | OIDC uygulamanız için Redirect URI           |

Yollar konsolun adresindedir; örneğin `https://console.aicodeops.dev`.

**SAML.** Kullanıcının e-posta adresini NameID olarak (email address biçimi) veya bir `email` attribute'u olarak gönderin. Assertion'lar, girdiğiniz sertifikayla imzalanmış olmalıdır. AI CodeOps imzayı, audience değerini, süre sonunu ve yanıtın kendi başlattığı bir girişe karşılık geldiğini kontrol eder. Giriş AI CodeOps'ta başlamalıdır; IdP'nizin panosundaki bir kutucuk çalışmaz.

**OIDC.** AI CodeOps `openid email profile` kapsamlarını ister ve PKCE kullanır.

## 4. Etkinleştirin ve bağlantıyı paylaşın

Yeni bir bağlantı, siz etkinleştirene kadar test aşamasındadır. Bu sırada yalnızca kuruluşunuzda zaten bulunan kişilerin girişine izin verir ve hesap oluşturmaz. Kendi hesabınızla denemek için konsolun adresinde `/sso/saml/<connection-id>/login` veya `/sso/oidc/<connection-id>/login` yolunu açın.

1. Bağlantı kartında **Activate** düğmesini seçin.
2. Giriş bağlantısını çalışanlarınızla paylaşın:

```text
https://console.aicodeops.dev/sso/login?domain=example.com
```

Alan adı eksikse bağlantı **Continue with single sign-on** ekranını açar; böylece insanlar iş e-postalarını oraya da yazabilir. Alan adı için etkin bağlantıyı bulur ve onları IdP'nize gönderir.

## Yeni kullanıcılar ve roller

İlk SSO girişi, kişinin hesabı yoksa hesabını oluşturur ve onu kuruluşunuza ekler.

Yeni kişileri doğrudan bir çalışma alanına yerleştirmek için o çalışma alanının ayarlarını açın ve bağlantı kartında **Set this workspace as SSO default** düğmesini seçin. Ona bağlantının **Default Role** rolüyle katılırlar. Varsayılan çalışma alanı yoksa, biri onları [davet edene](https://aicodeops.dev/tr/docs/members) kadar kendi kişisel çalışma alanlarına gelirler. Rollerini daha sonra değiştirebilirsiniz; bkz. [Roller ve izinler](https://aicodeops.dev/tr/docs/roles-and-permissions).

## Oturumlar kuruluşunuzun içinde kalır

SSO'nuz üzerinden yapılan bir giriş yalnızca kuruluşunuzun çalışma alanlarına ve kişinin kendi kişisel çalışma alanına ulaşır. Kişi orada üye olsa bile diğer kuruluşların çalışma alanları o oturum için engellenir.

## Devre dışı bırakın veya silin

- **Deactivate**, yeni SSO girişlerini durdurur ve kurulumu korur.
- **Delete**, siz **Delete connection** ile onayladıktan sonra bağlantıyı kaldırır. Kullanıcıları bundan sonra parolayla veya bir sosyal hesapla giriş yapar.

SSO değişiklikleri kuruluşa karşı `sso.connection.*` ve `sso.domain.*` denetim kayıtları olarak kaydedilir. Bir çalışma alanının [denetim günlüğü](https://aicodeops.dev/tr/docs/audit-logs) sayfasında görünmezler ve 7 gün saklanırlar.

## Sonraki adımlar

- [Enterprise'a genel bakış](https://aicodeops.dev/tr/docs/enterprise)
- [Roller ve izinler](https://aicodeops.dev/tr/docs/roles-and-permissions)
- [Enterprise planı](https://aicodeops.dev/tr/enterprise)

## Sık sorulan sorular

### SSO hangi plana dahil?

Enterprise. Diğer planlarda Single sign-on kartı, SSO'nun Enterprise planında sunulduğunu söyler.

### SAML metadata URL'si nerede?

Bağlantıyı oluşturduktan sonra bağlantı kartında, Metadata URL etiketiyle. /sso/saml/<connection-id>/metadata biçimindedir ve aynı zamanda service provider entity ID'sidir.

### SSO açıldıktan sonra insanlar yine parolayla giriş yapabilir mi?

Evet. SSO bir giriş yolu ekler; alan adınız için parolayla veya sosyal hesapla girişi kapatmaz.
