# Hazır bir öznitelik eşleme profilini uygula

`POST /v1/connections/{connection_id}/attribute-mappings:apply-profile` · izin `connections:write`

Kurumsal bir bağlantının sabit hedefli kurallarını (e-posta, adlar, gruplar…) hazır bir profilin kurallarıyla değiştirir: SAML için `entra`, `okta`, `google`, `ping`, `jumpcloud` veya `keycloak`, OIDC için `generic`. Kaydedilmiş `user_metadata.<key>` kuralları korunur. SAML konu özniteliği değiştirilmez: konu ayrıca yapılandırılır ve değiştirilmesi bağlı kimlikleri yetim bırakır. [Eşleme listesini değiştirme](put.md) için olduğu gibi `If-Match` zorunludur. Zaten uygulanmış bir profili yeniden uygulamak hiçbir şey yazmaz. Yazma işlemi, profil adıyla birlikte `connection.attribute_mappings_replaced` olarak denetlenir.

## İstek

| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
| `connection_id` | yol | evet | Kurumsal bağlantı kimliği (`conn_…`). |
| `If-Match` | üstbilgi | evet | Son okumadaki `ETag`. Eksikse: `428`; eskiyse: `412`. |
| `profile` | dize | evet | `entra`, `okta`, `google`, `ping`, `jumpcloud`, `keycloak` (SAML) veya `generic` (OIDC). |

## Yanıt

Kaydedilmiş listeyi ([Öznitelik eşlemelerini al](get.md) bölümüne bakın) ve yeni `ETag` değerini içeren `200 OK`.

## Hatalar

| HTTP | code | Ne zaman |
|---|---|---|
| 404 | `not_found` | Bağlantı bu ortamda yok veya kurumsal bir bağlantı değil. |
| 409 | `conflict` | Bağlantının protokolünün öznitelik eşlemesi yok (LDAP). |
| 412 | `precondition_failed` | `If-Match` geçerli sürümle eşleşmiyor veya liste eşzamanlı olarak değişti. |
| 422 | `validation_failed` | `profile` eksik, bilinmiyor veya bağlantının protokolünün hazır profili değil (`/profile`); ya da korunan bir `user_metadata` kuralı profil özniteliğini farklı bir NameFormat ile okuyor (`/profile`, `conflicts_with_stored_mappings`). |
| 428 | `precondition_required` | `If-Match` üstbilgisi eksik. |
| 401 | `unauthenticated` | Kimlik bilgisi eksik, geçersiz veya iptal edilmiş. |
| 403 | `insufficient_permissions` | Kimlik bilgisinde gerekli izin yok. |
| 429 | `rate_limited` | Hız sınırı aşıldı; `Retry-After` süresinden sonra yeniden deneyin. |
| 503 | `service_unavailable` | Bir bağımlılık geçici olarak kullanılamıyor; `Retry-After` süresinden sonra yeniden deneyin. |

## Örnek

```bash
curl -X POST "https://api.eu.keenauth.com/v1/connections/conn_01j9xp6q0r1s5t7v9w1x3y5z7b/attribute-mappings:apply-profile" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -H 'If-Match: "6f1c…"' \
  -d '{"profile":"entra"}'
```

```bash
keenauth connections attribute-mappings apply-profile conn_01j9xp6q0r1s5t7v9w1x3y5z7b --profile entra --if-match '"6f1c…"'
```