Atlantic ID Geliştirici Dokümantasyonu

Atlantic ID, CodeAtlantis ekosisteminin merkezi kimlik doğrulama servisidir. Modern web ve mobil uygulamalarınız için Single Sign-On (SSO) çözümü sağlar.

Atlantic ID Nedir?

Atlantic ID, kullanıcılarınızın tek bir hesapla tüm uygulamalarınıza güvenle giriş yapmasını sağlayan bir Identity Provider (IdP) servisidir. OAuth 2.0 ve OpenID Connect (OIDC) standartlarına tam uyumlu olarak çalışır.

Temel Özellikler

  • ✅ Tam OIDC Uyumluluğu - Standart OAuth2/OIDC kütüphaneleriyle çalışır
  • ✅ Güvenli Authentication - Passkey, 2FA, güçlü şifre politikaları
  • ✅ Hızlı Entegrasyon - 5 dakikada test ortamı hazır
  • ✅ Çoklu Platform Desteği - Web, mobil, native apps
  • ✅ Developer Friendly - Detaylı dokümantasyon ve SDK'lar
  • ✅ Privacy First - KVKK ve GDPR uyumlu

Nasıl Çalışır?

┌─────────────┐         ┌──────────────┐         ┌─────────────┐
│             │         │              │         │             │
│   Your App  │────────▶│ Atlantic ID  │────────▶│    User     │
│             │         │              │         │             │
└─────────────┘         └──────────────┘         └─────────────┘
      │                        │                        │
      │  1. Redirect login     │                        │
      │ ──────────────────────▶│                        │
      │                        │  2. Show login page    │
      │                        │ ──────────────────────▶│
      │                        │                        │
      │                        │  3. User authenticates │
      │                        │◀───────────────────────│
      │  4. Auth code          │                        │
      │◀───────────────────────│                        │
      │                        │                        │
      │  5. Exchange token     │                        │
      │───────────────────────▶│                        │
      │                        │                        │
      │  6. Access + ID token  │                        │
      │◀───────────────────────│                        │
      │                        │                        │
      │  7. Get user info      │                        │
      │───────────────────────▶│                        │

Hızlı Başlangıç

1. Developer Console'da Client Oluştur

Developer Console'a giriş yaparak yeni bir OAuth client oluşturun.

2. Discovery URL ile Konfigürasyon Al

curl https://id.codeatlantis.com/.well-known/openid-configuration

3. Authorization Flow Başlat

const authUrl = new URL('https://id.codeatlantis.com/oauth/authorize');
authUrl.searchParams.set('client_id', 'cli_your_id');
authUrl.searchParams.set('response_type', 'code');
authUrl.searchParams.set('scope', 'openid profile email');
authUrl.searchParams.set('redirect_uri', 'https://yourapp.com/callback');
authUrl.searchParams.set('state', randomState);
authUrl.searchParams.set('code_challenge', pkceChallenge);
authUrl.searchParams.set('code_challenge_method', 'S256');

window.location.href = authUrl.toString();

4. Token Al ve Kullanıcı Bilgilerini Çek

// Token exchange
const tokenResponse = await fetch('https://id.codeatlantis.com/oauth/token', {
  method: 'POST',
  headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
  body: new URLSearchParams({
    grant_type: 'authorization_code',
    code: authCode,
    redirect_uri: 'https://yourapp.com/callback',
    client_id: 'cli_your_id',
    code_verifier: pkceVerifier
  })
});

const { access_token, id_token } = await tokenResponse.json();

// User info
const userResponse = await fetch('https://id.codeatlantis.com/oauth/userinfo', {
  headers: { 'Authorization': `Bearer ${access_token}` }
});

const user = await userResponse.json();
console.log(user); // { sub, name, email, ... }

Developer Portal İçeriği

📖 Temel Konular

🔌 Entegrasyon

💻 SDK ve Örnekler

  • JavaScript/TypeScript - React, Vue, Node.js
  • PHP - Laravel, Symfony örnekleri
  • Python - Django, Flask örnekleri
  • Go - Fiber, Gin örnekleri
  • Java - Spring Boot örnekleri
  • .NET - ASP.NET Core örnekleri

🔒 Güvenlik

🛠️ Gelişmiş

Desteklenen Standartlar

Atlantic ID aşağıdaki standartlara tam uyumludur:

Developer Console

Atlantic ID'yi kullanmaya başlamak için Developer Console'a giriş yapın:

  • 🔑 Client oluşturma ve yönetimi
  • 📊 Kullanım istatistikleri
  • 🔍 Request log'ları
  • ⚙️ Redirect URI yönetimi
  • 📱 Test credentials

Destek ve Topluluk

Sorularınız mı var? Yardıma mı ihtiyacınız var?

SLA ve Garantiler

  • ✅ 99.9% Uptime - Production ortamları için
  • ✅ 24/7 Monitoring - Anlık durum bildirimleri
  • ✅ Fast Response Time - Ortalama 50ms yanıt süresi
  • ✅ Rate Limit: 100 req/dk per IP (authentication endpoints)

Sık Sorulan Sorular

S: Atlantic ID ücretsiz mi?
C: Evet, beta süresince tamamen ücretsiz. Ücretlendirme planı announce edilecek.

S: Hangi authentication yöntemlerini destekliyor?
C: Atlantic ID şifre, Passkey (WebAuthn), 2FA (TOTP) destekler. Ancak bunları siz implement etmenize gerek yok, kullanıcılar Atlantic ID'de login olurken kullanır.

S: Custom domain kullanabilir miyim?
C: Şu an hayır, sadece id.codeatlantis.com kullanılabilir.

S: Hangi platformlarda çalışır?
C: Web (SPA, MPA), mobile (iOS, Android), desktop, backend - tüm platformlar desteklenir.

S: SAML destekliyor mu?
C: Şu an sadece OAuth2/OIDC. SAML desteği roadmap'te.

Güncellemeler

v1.2.0 (Ocak 2025)

  • ✨ Refresh token rotation eklendi
  • 🔒 Token binding desteği
  • 📱 Device flow beta

v1.1.0 (Aralık 2024)

  • ✨ PKCE zorunlu hale getirildi (public clients)
  • 🚀 Performance iyileştirmeleri
  • 📊 Developer Console yenilendi

Entegrasyona başlamak için Hızlı Başlangıç sayfasına göz atın!