Müşteri Adına Oturum Açma

Kendi sisteminizden bir müşteriye giriş yapılmış oturum devredin; parolasını hiç görmeden.

Genel Bakış

İki uç, müşterinin sizin sisteminizden kendi paneline geçtiği anı karşılar.

Ziyaretçinin kim olduğunu zaten biliyorsanız ikincisini kullanın: kendi portalınız, bir kontrol paneli, bir destek aracı. Birincisi yalnız parolayı siz soruyorsanız gerekir.

Ön Koşullar

Yapı

Bilet bir veri paketi değil, rastgele bir gizli değerdir. Girişin ihtiyaç duyduğu her şey — son geçerlilik ve inilecek sayfa — hesapta saklanır. Böylece çağıranın eline geçen değer başka bir hedefe ya da daha uzun bir süreye çevrilemez.

Adım Adım

Müşteriyi İçeri Almak

1. Sisteminiz bu ziyaretçinin hangi müşteri olduğuna karar verir. O müşterinin kimliğiyle POST /clients/sso çağırın. Yanıtta token, url ve expires_at döner.
2. Ziyaretçiyi hemen url adresine yönlendirin. Sonrası için bağlantı olarak göstermeyin — bilet 60 saniye geçerlidir.
3. Ziyaretçi giriş yapmış olarak varır; panosuna ya da destination ile belirttiğiniz sayfaya. Bilet harcanmıştır, aynı adres ikinci kez çalışmaz.

İnilecek Sayfayı Seçmek

1. destination vermezseniz müşteri panosuna iner.
2. Daha derine indirmek için route anahtarını parametreleriyle gönderin: "destination": "services", "destination_values": [128].
3. Mutlak adres de çalışır, yeter ki bu kuruluma ait olsun. Başka bir yeri gösteren adres yok sayılır ve müşteri panosuna iner.

Referans

Bilet İsteği

Biletin Davranışı

Alan tabloları, hata kodları ve yanıt şekilleri clients uç referansındadır.

Örnek

curl -X POST 'https://panel.example.com/api/v1/admin/clients/sso' \
  -H "Authorization: Bearer $API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"client_id":64,"destination":"services","destination_values":[128]}'

const res = await fetch('https://panel.example.com/api/v1/admin/clients/sso', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${apiKey}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    client_id: 64,
    destination: 'services',
    destination_values: [128],
  }),
});

const body = await res.json();

// Yonlendirmeyi anahtari tutan sunucudan yapin, ziyaretcinin tarayicisindan degil:
// bilet bir kimlik bilgisidir, guvenilmeyen koddan gecmemelidir.
res.ok && console.log(body.data.url);

<?php

$ch = curl_init('https://panel.example.com/api/v1/admin/clients/sso');

curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . $apiKey,
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS     => json_encode(['client_id' => 64]),
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);

// Ziyaretciyi hemen gonderin; bilet 60 saniye sonra gecersiz olur.
header('Location: ' . $body['data']['url']);
exit;

$response = Api::Clients()->CreateClientSsoToken([
    'client_id'   => 64,
    'destination' => 'services',
    'destination_values' => [128],
]);

// Anahtar yok, HTTP turu yok — ayni kaynak, surec icinde cagrilir.
Utility::redirect($response['data']['url']);

Tuzaklar

İlgili Makaleler

• Müşteri Uçları
• Müşteri Güvenlik Uçları