sgcAuth'un yaptığı her şey; iki istemci bileşeni, uyguladıkları akış tipleri ve talepler, ayrıca paketin sgcCustomIndy ile birlikte açtığı WebAuthn yeteneği üzerinden eşlenmiş. Her yetenek Delphi ve C++ Builder'da aynı şekilde çalışır ve her lisans tam kaynak koduyla gelir.
Beş akış tipi, tek bileşen
İmzalayın, ekleyin ya da doğrulayın
Passkey'ler, sgcCustomIndy aracılığıyla
Delphi 7'den 13'e, C++ Builder
sgcAuth kendi kendine yeterlidir. sgcWebSockets Core çalışma zamanı pakete dahil olarak gelir, bu yüzden OAuth2 ve JWT istemcileri için bir eklenti değildir.
sgcWebSockets içinde de var. Hem OAuth2 Client hem de JWT Client, sgcWebSockets sürümlerinin içinde Standard sürümünden itibaren gelir. All-Access her şeyi içerir. sgcAuth, yalnızca kimlik doğrulama istemcilerine ihtiyaç duyan ekipler için bağımsız pakettir.
Aynı sorunun iki yüzü, SGC Auth palet sayfasında kayıtlıdır.
| Bileşen | Sınıf | İş | Açıklama |
|---|---|---|---|
| OAuth2 Client | TsgcHTTP_OAuth2_Client | Bir token alın | Herhangi bir OAuth2/OIDC sağlayıcısına karşı Authorization Code, PKCE, Client Credentials, Resource Owner Password ve Device Code akışları; yerleşik bir yerel yönlendirme sunucusuyla birlikte. |
| JWT Client | TsgcHTTP_JWT_Client | Bir token imzalayın | JSON Web Token'ları oluşturur, imzalar ve doğrular; tek başına ya da TsgcWebSocketClient, TsgcHTTP1Client ve TsgcHTTP2Client için Bearer token kaynağı olarak. |
TsgcHTTP_OAuth2_Client, OAuth 2.0'ı (RFC 6749) uçtan uca kapsar: akışı başlatır, yönlendirmeyi yakalar, kodu bir token ile değiştirir ve sonrasında token'ı yönetir.
| Yetenek | API | Notlar |
|---|---|---|
| Authorization Code | OAuth2Options.GrantType := auth2Code | Bir istemci gizli anahtarı tutabilen, güvenilir sunucu taraflı web uygulamaları için standart akış. |
| Authorization Code + PKCE | auth2CodePKCE (RFC 7636) | Bir gizli anahtar tutamayan yerel, mobil ve tek sayfa uygulamalar için, bir Proof Key for Code Exchange ile aynı akış. |
| Client Credentials | auth2ClientCredentials | Aradan bir kullanıcı geçmeyen sunucudan sunucuya çağrılar: daemon'lar ve servis hesapları. |
| Resource Owner Password | auth2ResourceOwnerPassword | Uygulama, kullanıcının parolasını doğrudan toplar ve onu bir token ile değiştirir. |
| Device Code | auth2DeviceCode (RFC 8628) | Girdi kısıtlı cihazlar, akıllı TV'ler, medya konsolları, IoT için: kişinin ikinci bir cihazda girdiği bir kullanıcı kodu gösterir. |
| İstemci kimliği | OAuth2Options.ClientId, ClientSecret, Username, Password | Sağlayıcınızın API şartnamesine göre ayarlanır; Username/Password, token uç noktasında Basic Authentication gerektiren sağlayıcıları kapsar. |
| Sağlayıcı uç noktaları | AuthorizationServerOptions.AuthURL, TokenURL, Scope, RevocationURL, IntrospectionURL | Sağlayıcınızın OAuth2/OIDC belgelerinde yayımlanan URL'ler ve kapsam listesi. |
| Sosyal ön ayarlar | TsgcHTTP_OAuth2_Client_Google, TsgcHTTP_OAuth2_Client_Microsoft | Google ve Microsoft uç noktalarını ve kapsamlarını önceden yapılandıran hazır alt sınıflar. |
| Yerel yönlendirme dinleyicisi | LocalServerOptions.IP, Port, RedirectURL | Bileşenin authorization-code yönlendirmesini almak için başlattığı küçük HTTP sunucusu; varsayılan olarak 8080 bağlantı noktası, masaüstü uygulamaları için rastgele bir bağlantı noktası seçmek üzere 0. |
| Akışı çalıştırma | Start, Stop | Start, sistem tarayıcısını açar (ya da Device Code'u verir) ve yapılandırılmış akışı başlatır; Stop onu durdurur ve yerel dinleyiciyi kapatır. |
| Yenileme | Refresh | Başka bir tarayıcı gidiş-dönüşü olmadan bir yenileme token'ını yeni bir erişim token'ı ile değiştirir. |
| İptal & sorgulama | Revoke (RFC 7009), Introspect (RFC 7662) | Bir token'ı geçersiz kılın veya sağlayıcıdaki durumunu ve meta verilerini sorgulayın. |
| DPoP | DPoPOptions, GenerateDPoPKeyPair, OnDPoPSign | Token'ları bir anahtar çiftine bağlayan sağlayıcılar için Demonstrating Proof-of-Possession (RFC 9449) anahtar malzemesi ve imzalama. |
| HTTP taşıması | HTTPClientOptions | Token, revocation ve introspection uç noktalarına POST yapan dahili HTTP istemcisi için TLS ve günlükleme yapılandırması. |
| Yaşam döngüsü olayları | OnBeforeAuthorizeCode, OnAfterAuthorizeCode, OnBeforeAccessToken, OnAfterAccessToken, OnBeforeRefreshToken, OnAfterRefreshToken | Akışın her adımının etrafında önce/sonra çiftleri. |
| Hata olayları | OnErrorAccessToken, OnErrorAuthorizeCode, OnErrorRefreshToken, OnErrorRevokeToken, OnErrorIntrospectToken | Akıştaki her hata noktası için bir tane, her biri sağlayıcının hatasını, açıklamasını ve URI'sini taşır. |
| Device Code olayları | OnDeviceCode, OnDeviceCodeExpired | Görüntülenecek kullanıcı kodunu ve doğrulama URI'sini teslim eder, kullanıcı yetkilendirmeyi zamanında tamamlamazsa tetiklenir. |
TsgcHTTP_JWT_Client, tek bir JWTOptions özelliği üzerinden RFC 7519 (JSON Web Token), RFC 7515 (JWS) ve RFC 7516'yı (JWE) uygular.
| Yetenek | API | Notlar |
|---|---|---|
| Header | JWTOptions.Header.alg, typ, kid | JOSE başlığı. alg, jwtHS256/384/512, jwtRS256/384/512 ya da jwtES256/384/512'yi seçer; ek alanlar Header.AddKeyValue üzerinden eklenir. |
| Payload / talepler | JWTOptions.Payload.iss, sub, aud, exp, nbf, iat, jti | Kayıtlı RFC 7519 talepleri; özel talepler Payload.AddKeyValue ile eklenir. |
| İmzalama anahtar malzemesi | JWTOptions.Algorithms.HS.Secret, RS.PrivateKey, ES.PrivateKey | HMAC için paylaşılan gizli anahtar, RSA veya ECDSA için PEM kodlu özel anahtar; Header.alg ile seçilir. |
| Otomatik yenileme | JWTOptions.RefreshTokenAfter | Sıfırdan büyük olduğunda, Sign iat'i yeniler ve exp'i otomatik olarak yeniden hesaplar; 0 her istekte token'ı yeniden üretir. |
| Bağımsız imzalama | Sign | Kodlanmış token'ı (header.payload.signature) tek bir dize olarak oluşturur, imzalar ve döndürür; HTTP veya WebSocket istemcisi gerekmez. |
| Bir istemciye ekleme | Start, Client.Authentication.Token.JWT | Start, yapılandırılmış JWT'yi imzalar ve barındıran bileşene Bearer token olarak teslim eder; bir kez Authentication.Token.JWT üzerinde ayarlayın, her istek imzalı olarak gider. |
| Şununla çalışır | TsgcWebSocketClient, TsgcHTTP1Client, TsgcHTTP2Client | Üçünden herhangi biri, Authentication.Token üzerinden Bearer token kaynağı olarak bir TsgcHTTP_JWT_Client kabul eder. |
| OpenSSL yapılandırması | JWTOptions.OpenSSL_Options | RS ve ES algoritmalarının kullandığı API sürümü ve kitaplık yolu (APIVersion, LibPath, LibPathCustom, UnixSymLinks). |
WebAuthn, sgcAuth hikayesinin bir parçasıdır, ama bu pakette üçüncü kayıtlı bir bileşen değildir. sgcWebSockets WebAuthn sunucusu tarafından sağlanır ve altında sgcCustomIndy'ye ihtiyaç duyar.
| Alan | Ayrıntı |
|---|---|
| Ne olduğu | W3C Web Authentication Level 2 (WebAuthn): passkey'ler ve FIDO2 güvenlik anahtarlarıyla parolasız oturum açma, TsgcWSAPIServer_WebAuthn tarafından desteklenir. |
| Nerede bulunduğu | TsgcWSAPIServer_WebAuthn, sgcWebSockets Enterprise ve All-Access'in bir parçası olan sunucu taraflı bir bileşendir, bu pakette kayıtlı bir istemci değildir. |
| Neye ihtiyaç duyduğu | sgcCustomIndy'nin sgcWebSockets Core için bir eklenti olarak sunduğu yamalanmış Indy derlemesi. |
| Nasıl eklendiği | Sipariş sayfası, sgcAuth sipariş ettiğinizde sgcCustomIndy'yi otomatik olarak sepetinize ekler. Zaten bir lisansınız mı var? Ödeme sırasında satırı kaldırın, her iki durumda da ek ücret yoktur. |
| İstemci tarafı | Tarayıcı taraflı bir JavaScript uygulaması WebAuthn seremonisini yürütür; sgcHTML, sunucuyla eşleşen hazır bir WebAuthn login arayüz bileşeni sunar. |
Standart yolundaki şartnameler ve desteklenen her derleyicide aynı kaynak kodu.
| Alan | Ayrıntı |
|---|---|
| OAuth2 standartları | OAuth 2.0 (RFC 6749), PKCE (RFC 7636), Device Authorization Grant (RFC 8628), Token Revocation (RFC 7009), Token Introspection (RFC 7662), DPoP (RFC 9449). |
| JWT standartları | JSON Web Token (RFC 7519), JSON Web Signature (RFC 7515), JSON Web Encryption (RFC 7516). |
| WebAuthn standardı | Web Authentication Level 2 (W3C), sgcWebSockets WebAuthn sunucusu üzerinden. |
| Platformlar | Her iki istemci de düz HTTPS ve yerel imzalamadır, bu yüzden her Delphi platformu kapsanır: Windows Win32/Win64, Linux 64-bit, macOS, iOS ve Android. |
| Derleyiciler | Delphi ve C++ Builder 7'den 13'e. |
| Sürümler | OAuth2 Client ve JWT Client ayrıca sgcWebSockets içinde Standard sürümünden itibaren gelir, All-Access her şeyi içerir. |
| Lisanslama | Bağımsız. sgcWebSockets Core çalışma zamanı pakete dahildir ve tam kaynak kodu içerilir. |