sgcAuth: Delphi ve C++ Builder için OAuth2, JWT ve WebAuthn Bileşenleri
İki istemci bileşeni, modern kimlik doğrulamanın token tarafını uygulamanıza taşır. TsgcHTTP_OAuth2_Client, herhangi bir OAuth2/OIDC sağlayıcısına karşı Authorization Code, PKCE, Client Credentials, Resource Owner Password ve Device Code akışlarını çalıştırır. TsgcHTTP_JWT_Client, JSON Web Token'ları tek başına ya da WebSocket ve HTTP istemcileriniz için Bearer token kaynağı olarak oluşturur, imzalar ve doğrular. Beş bileşen daha; TOTP ikinci faktörleri, LDAP ve Active Directory ile oturum açma, SAML tek oturum açma, OpenID Connect ve posta için OAuth2 ekler. sgcAuth bağımsızdır, her iki istemcinin de üzerine kurulduğu sgcWebSockets Core çalışma zamanını içerir.
Pakete dahil çalışma zamanısgcWebSockets CoreHer iki istemcinin de altındaki HTTP, TLS ve JSON çalışma zamanı
OAuth2TsgcHTTP_OAuth2_Client
JWTTsgcHTTP_JWT_Client
ÇALIŞIRKEN İZLEYİN
sgcAuth'u İki Dakikada Görün
Delphi ve C++Builder'da OAuth2, JWT ve WebAuthn passkey'leri; hem istemcide hem de kendi sunucunuzda.
7BileşenBileşen paletinde tek bir sayfa
9Uygulanan RFCOAuth2, PKCE, DPoP, Device Code, JWT/JWS/JWE ve daha fazlası
5PlatformWindows, macOS, Linux, iOS ve Android
100%Kaynak kodu dahilHer iki istemci ve pakete dahil Core çalışma zamanı
12Ay güncellemeLisansınız aktifken yayımlanan her sürüm
SATIN ALMADAN ÖNCE
Önce Bilmeye Değer Üç Şey
sgcAuth'un sizden ne istediği, bu bileşenlere zaten sahip olup olmadığınız ve WebAuthn'in üstüne ne gerektirdiği. Üç yanıt da kısa.
sgcAuth kendi kendine yeter
Bağımsız olarak, sgcWebSockets Core çalışma zamanı pakete dahildir: her iki bileşenin de token isteklerini POST ettiği HTTP/TLS istemci yığını ve yanıtları ayrıştıran JSON altyapısı. Tek SKU, tek kurulum paketi.
Her lisansla birlikte tam kaynak kodu gelir, böylece her iki istemci ve altlarındaki çalışma zamanı bir ikili dosyanın içinde kaybolmak yerine kendi hata ayıklayıcınızda adım adım izlenir.
Sürüm örtüşmesi
sgcWebSockets sürümünüzde zaten var mı?
Hem OAuth2 Client hem de JWT Client, sgcWebSockets içinde Standard sürümünden itibaren gelir; bu yüzden herhangi bir sgcWebSockets sürümüne sahipseniz her iki bileşene de zaten sahipsinizdir. WebAuthn, TOTP, LDAP, SAML, OpenID Connect ve Mail OAuth2 bileşenleri Enterprise'da yer alır. All-Access her şeyi içerir.
sgcAuth, tam tersi durum için vardır: tam bir sgcWebSockets sürümü lisanslamadan Delphi veya C++ Builder'da OAuth2 ve JWT istemci desteği istiyorsunuz. Satın almadan önce sürümünüzün zaten neyi kapsadığını kontrol edin.
Eklenti gerekli
WebAuthn, sgcCustomIndy gerektirir
WebAuthn ve passkey'lerle parolasız oturum açma, sgcCustomIndy'nin eklenti olarak sunduğu yamalanmış Indy kitaplığı üzerine kurulu bir sgcWebSockets Enterprise/All-Access bileşeni olan TsgcWSAPIServer_WebAuthn tarafından sağlanır. WebAuthn, sgcCustomIndy eklentisini gerektirir; sgcAuth sipariş edildiğinde bu otomatik olarak eklenir. TOTP, LDAP, SAML, OpenID Connect ve Mail OAuth2 bileşenlerinin kilidi de aynı eklentiyle açılır.
Zaten bir sgcCustomIndy lisansına mı sahipsiniz? Ödeme öncesi sepetinizden otomatik eklenen satırı kaldırın, her iki durumda da ek ücret yoktur.
KUTUDA NELER VAR
Token İstemcileri, İkinci Faktörler ve Tek Oturum Açma
Her biri, bir forma bırakabileceğiniz ya da kodda oluşturabileceğiniz görsel olmayan bir bileşendir; sgc önekiyle tanımlanır ve SGC Auth palet sayfasında kayıtlıdır. Sağlayıcı bilgilerini ayarlayın, olayları bağlayın, ardından Start'ı çağırın. TOTP, LDAP, SAML, OpenID Connect ve Mail OAuth2 bileşenlerinin kilidi, WebAuthn gibi sgcCustomIndy ile birlikte açılır.
OAuth21 bileşen
Beş akış tipi, tek bileşen
TsgcHTTP_OAuth2_Client, OAuth2Options.GrantType'ı; güvenilir sunucu taraflı uygulamalar için auth2Code, yerel, mobil ve tek sayfa uygulamalar için auth2CodePKCE, daemon'lar ve servis hesapları için auth2ClientCredentials, auth2ResourceOwnerPassword ve akıllı TV'ler, kiosklar ve diğer girdi kısıtlı cihazlar için auth2DeviceCode (RFC 8628) üzerinden çalıştırır. AuthorizationServerOptions'ı sağlayıcının authorize, token, revocation ve introspection uç noktalarına yönlendirin; bileşen gerisini halleder: Active/Start çalıştığında Authorization Code akışı, sistem tarayıcısını açar ve yönlendirmeyi yakalamak için LocalServerOptions'tan küçük bir yerel HTTP sunucusu ayağa kaldırır, kodu HTTPClientOptions üzerinden düz HTTPS ile token ile değiştirir. Bundan sonra token yaşam döngüsünü Refresh, Revoke ve Introspect kapsar; DPoPOptions ve GenerateDPoPKeyPair ise bunu gerektiren sağlayıcılar için DPoP proof-of-possession (RFC 9449) ekler. Hazır Google ve Microsoft ön ayarları, yaygın uç noktaları ve kapsamları sizin için yapılandırır.
TsgcHTTP_JWT_Client, RFC 7519'un ihtiyaç duyduğu her şeyi JWTOptions üzerinden yayınlar: JOSE Header (alg, typ, kid), kayıtlı Payload talepleri (iss, sub, aud, exp, nbf, iat, jti, artı AddKeyValue üzerinden özel talepler) ve HMAC (HS.Secret), RSA (RS.PrivateKey) ve ECDSA (ES.PrivateKey) için Algorithms altındaki anahtar malzemesi. Yerleşik HTTP ya da WebSocket istemcisi olmayan hizmetler için doğrudan compact-serialization token'ı geri almak üzere Sign'ı çağırın, ya da RefreshTokenAfter'ı ayarlayın ve bileşenin iat/exp'i otomatik olarak yenileyip yeniden imzalamasına izin verin. Aynı bileşen, TsgcWebSocketClient, TsgcHTTP1Client ve TsgcHTTP2Client üzerindeki Authentication.Token.JWT'ye doğrudan takılır; böylece giden her istek, siz başlığa dokunmadan taze bir Bearer token taşır.
Her biri yalnızca bir kez kabul edilen ikinci faktör kodları
TsgcTOTPAuthenticator, Google Authenticator ve Microsoft Authenticator dahil herhangi bir kimlik doğrulayıcı uygulamasının altı haneli kodlarını oturum açmanıza ekler. GenerateSecret, rastgele bir Base32 gizli anahtarı oluşturur ve GetProvisioningURI, kayıt sırasında QR kodu olarak göstereceğiniz otpauth:// URI'sini oluşturur. VerifyCode, kullanıcının girdiğini saat kayması için ayarlanabilir bir Window ile denetler; tekrar oynatma korumalı aşırı yüklemesi aynı zaman adımını asla iki kez kabul etmez. GenerateHOTP ve VerifyHOTP, sayaç tabanlı donanım tokenlerini kapsar; GenerateRecoveryCodes, tek kullanımlık yedek kodlardan oluşan bir liste doldurur; Algorithm, Digits ve Period ise 6 ila 8 haneli kodlarla HMAC-SHA1, HMAC-SHA256 veya HMAC-SHA512'yi seçer.
TsgcLDAPClient, kullanıcı adlarını ve parolaları Active Directory'ye veya başka herhangi bir LDAP dizinine karşı denetleyen bir LDAP v3 istemcisidir. Security, 636 portunda LDAPS veya 389 portunda StartTLS'yi seçer; reddedilen bir StartTLS, düz metne geri dönmek yerine bağlantıyı kapatır. AuthenticationMode, kullanıcının girdiğini bir UPN, bir DOMAIN\user adı, tam bir DN veya UserSearchFilter ile bir arama izleyen bir hizmet bind'i olarak bind adına çevirir; Authenticate ise tüm denetimi tek bir çağrıda yapar. GetUserGroups, LDAP_MATCHING_RULE_IN_CHAIN üzerinden doğrudan veya iç içe grup üyeliğini döndürür, Search büyük sonuç kümelerini otomatik olarak sayfalar ve her genel metot serileştirilmiştir; böylece tek bir örnek çok iş parçacıklı bir sunucuya hizmet verebilir.
TsgcSAMLServiceProvider, Delphi web uygulamanızı Microsoft Entra ID, Okta, AD FS, Google Workspace, Keycloak ve diğer kimlik sağlayıcılar için bir SAML 2.0 hizmet sağlayıcı yapar. GetMetadata, IdP'de kaydedeceğiniz meta veriyi üretir ve LoadIdPMetadata onlarınkini okur. GetAuthnRequestRedirectURL ve GetAuthnRequestPostForm, tarayıcıyı Redirect veya POST bağlaması üzerinden oturum açmaya gönderir; ProcessResponse ise geri geleni doğrular: imza yalnızca güvenilir IdPCertificates'e karşı, imza sarmalamayı etkisiz kılmak için tam olarak bir assertion, ardından issuer, audience, destination, InResponseTo, geçerlilik penceresi ve bir tekrar oynatma önbelleği. Sonuç, NameID, oturum indeksi ve öznitelikleriyle bir TsgcSAMLResult olarak gelir.
TsgcHTTP_OIDC_Client, OAuth2 istemcisini OpenID Connect ile genişletir. OIDCOptions.Issuer'ı ayarlayın; Discover, sağlayıcı yapılandırmasından uç noktaları ve JWKSURI'yi doldurur. Start, PKCE ve taze bir nonce ile tarayıcıda oturum açmayı yürütür, ardından ID token imzasını, issuer'ı, audience'ı, süresini ve nonce'ı doğrular; yalnızca RS256, RS384, RS512, ES256 ve ES384'ü kabul eder, none veya HS algoritmalarını asla kabul etmez. OnOIDCIDToken talepleri iletir, GetUserInfo profili döndürür ve iş parçacığı güvenli bir anahtar önbelleği, yeniden başlatma gerektirmeden anahtar rotasyonunu takip eder. Sunucu tarafında, sgcOIDC_ValidateIDToken, REST API'nizin veya WebSocket sunucunuzun aldığı bearer token'larını aynı önbelleğe karşı denetler.
TsgcMailOAuth2, Microsoft 365 ve Gmail'in posta için beklediği token'ları alır. Provider'ı (mopMicrosoft365, mopGmail veya mopCustom) ve kullandığınız Protocols'ü seçin; bileşen eşleşen kapsamları ister. Flow, PKCE ve bir loopback yönlendirmesiyle tarayıcıda oturum açmayı ya da servisler ve konsollar için cihaz kodu akışını yürütür. Refresh, erişim token'ını yeniler ve OnTokensChanged her seferinde tetiklenir; böylece yeni refresh token'ı saklayabilirsiniz. GetXOAuth2 ve GetOAuthBearer, Indy TIdSMTP, TIdIMAP4 ve TIdPOP3 veya başka herhangi bir posta kütüphanesi için hazır olan AUTH XOAUTH2 ve AUTH OAUTHBEARER için SASL dizelerini döndürür.
TsgcMailOAuth2RFC 7628 · XOAUTH2 · Microsoft 365 · Gmail
KULLANIM SENARYOLARI
Delphi Kodundan Kimlik Doğrulama Akışları
Her iki bileşen de sıradan, görsel olmayan bileşenlerdir; bu yüzden uygulamanız her ne ise onun içine yerleşirler: bir VCL masaüstü uygulaması, bir Windows hizmeti, bir Linux daemon'u. Bunlar müşterilerin oluşturduğu kalıplardır, her biri onu yönlendiren özellik ya da metotla eşleştirilmiştir.
SI
Google veya Microsoft ile oturum açmaauth2CodePKCE
Hazır Google ve Microsoft ön ayarları, authorize ve token uç noktalarını ve kapsamları sizin için yapılandırır.
M2
Sunucudan sunucuya API erişimiauth2ClientCredentials
Arka plan işleri ve servis hesapları, aradan bir kullanıcı geçmeden bir API'ye kimlik doğrular.
Cihaz kısa bir kod gösterir, kullanıcı oturum açmayı telefonunda veya dizüstü bilgisayarında tamamlar.
RF
Yeniden yönlendirmeden uzun oturumlarRefresh
Bir yenileme token'ını arka planda yeni bir erişim token'ı ile değiştirin, tarayıcıya geçiş gerekmez.
WS
Kendi WebSocket & HTTP API'lerinizde kimlik doğrulayınAuthentication.Token.JWT
JWT Client, TsgcWebSocketClient, TsgcHTTP1Client ve TsgcHTTP2Client için Bearer token'ları otomatik olarak imzalar.
SG
Bağımsız token imzalamaSign
Herhangi bir kod tabanı için bir JWT dizesi oluşturun ve imzalayın, WebSocket veya HTTP bileşeni gerekmez.
NASIL ÇALIŞIR
Bir Tarayıcı Devri, Bir İmza ve Pakete Dahil Bir Çalışma Zamanı
OAuth2 ve JWT farklı sorunları çözer, biri uzak bir sunucuyla bir token üzerinde anlaşır, diğeri yerel olarak birini imzalar; ikisini birlikte paketlemenin amacı da tam olarak budur: sgcAuth bu farkı aynı bileşen kurallarının arkasına gizler, alt tesisat işini ise pakete dahil sgcWebSockets Core çalışma zamanı yapar.
OAuth2 bir tarayıcı devridir, ardından düz HTTPS
Start, sistem tarayıcısını açar (ya da Device Code için, görüntülemeniz gereken kullanıcı kodunu size verir) ve LocalServerOptions'tan bir yerel HTTP dinleyicisi yetkilendirme yönlendirmesini yakalar. Erişim token'ı için değişim, HTTPClientOptions üzerinden, Core çalışma zamanının HTTP istemci yığınında verilen düz bir HTTPS POST'tur.
JWT imzalamadır, ağ işi değil
TsgcHTTP_JWT_Client asla bir soket açmaz. JWTOptions, başlığı, yükü ve anahtar malzemesini yapılandırır; Sign ise compact-serialization token'ı döndürür, HMAC, RSA veya ECDSA, kendi kodunuzun gönderdiği herhangi bir isteğe eklenmeye hazır.
Core çalışma zamanı kutudadır
Bağımsız olarak, sgcWebSockets Core çalışma zamanı pakete dahildir. Her iki bileşenin de POST işlemi yaptığı HTTP/TLS istemci yığınını ve yanıtları okuyan JSON ayrıştırıcısını sağlar; tam kaynak kodu da her şey gibi paketin bir parçasıdır.
WebAuthn üçüncü parçadır, sgcCustomIndy üzerinden
Parolasız oturum açma, sgcCustomIndy'nin sunduğu yamalanmış Indy derlemesine ihtiyaç duyan bir sgcWebSockets Enterprise/All-Access sunucu bileşeni olan TsgcWSAPIServer_WebAuthn tarafından ele alınır. sgcAuth sipariş etmek, sgcCustomIndy'yi otomatik olarak sepetinize ekler.
HIZLI BAŞLANGIÇ
Bir Token Alın, Bir Token İmzalayın
Her iki bileşen de aynı şekli izler: seçenekleri yapılandırın, ardından bir metot çağırın. Delphi 7'den 13'e ve C++ Builder'da derlenirler, aynı özellikler .NET'te de sunulur.
uses
sgcHTTP, sgcHTTP_OAuth_Types, sgcHTTP_JWT_Types;
var
OAuth2: TsgcHTTP_OAuth2_Client;
JWT: TsgcHTTP_JWT_Client;
begin// OAuth2: Authorization Code Grant with PKCE
OAuth2 := TsgcHTTP_OAuth2_Client.Create(nil);
OAuth2.OAuth2Options.GrantType := auth2CodePKCE;
OAuth2.OAuth2Options.ClientId := 'your-client-id';
OAuth2.AuthorizationServerOptions.AuthURL := 'https://provider.com/oauth2/authorize';
OAuth2.AuthorizationServerOptions.TokenURL := 'https://provider.com/oauth2/token';
OAuth2.AuthorizationServerOptions.Scope.Clear;
OAuth2.AuthorizationServerOptions.Scope.Add('openid');
OAuth2.AuthorizationServerOptions.Scope.Add('profile');
OAuth2.LocalServerOptions.IP := '127.0.0.1';
OAuth2.LocalServerOptions.Port := 8080;
OAuth2.OnAfterAccessToken := OAuth2AccessToken;
OAuth2.Start; // opens the browser; the redirect lands on the local server// JWT: sign a token for your own API
JWT := TsgcHTTP_JWT_Client.Create(nil);
JWT.JWTOptions.Header.alg := jwtHS256;
JWT.JWTOptions.Algorithms.HS.Secret := '79F66F1E-E998-436B-8A0A-3E5DEFA4FD9E';
JWT.JWTOptions.Payload.iss := 'your-service';
JWT.JWTOptions.Payload.sub := '1234567890';
JWT.JWTOptions.Payload.iat := DateTimeToUnix(Now);
ShowMessage(JWT.Sign);
end;
procedure TForm1.OAuth2AccessToken(Sender: TObject; const Access_Token,
Token_Type, Expires_In, Refresh_Token, Scope, RawParams: String;
var Handled: Boolean);
begin
Memo1.Lines.Add('Access token received.');
end;
Aynı JWT bileşeni doğrudan bir WebSocket veya HTTP istemcisine eklenir: Client.Authentication.Token.Enabled := True ve Client.Authentication.Token.JWT := JWT'yi ayarlayın, böylece her istek taze bir Bearer token ile gider.
// include: sgcHTTP.hpp, sgcHTTP_OAuth_Types.hpp, sgcHTTP_JWT_Types.hpp// OAuth2: Authorization Code Grant with PKCE
TsgcHTTP_OAuth2_Client *OAuth2 = new TsgcHTTP_OAuth2_Client(this);
OAuth2->OAuth2Options->GrantType = auth2CodePKCE;
OAuth2->OAuth2Options->ClientId = "your-client-id";
OAuth2->AuthorizationServerOptions->AuthURL = "https://provider.com/oauth2/authorize";
OAuth2->AuthorizationServerOptions->TokenURL = "https://provider.com/oauth2/token";
OAuth2->AuthorizationServerOptions->Scope->Clear();
OAuth2->AuthorizationServerOptions->Scope->Add("openid");
OAuth2->AuthorizationServerOptions->Scope->Add("profile");
OAuth2->LocalServerOptions->IP = "127.0.0.1";
OAuth2->LocalServerOptions->Port = 8080;
OAuth2->OnAfterAccessToken = OAuth2AccessToken;
OAuth2->Start(); // opens the browser; the redirect lands on the local server// JWT: sign a token for your own API
TsgcHTTP_JWT_Client *JWT = new TsgcHTTP_JWT_Client(this);
JWT->JWTOptions->Header->alg = jwtHS256;
JWT->JWTOptions->Algorithms->HS->Secret = "79F66F1E-E998-436B-8A0A-3E5DEFA4FD9E";
JWT->JWTOptions->Payload->iss = "your-service";
JWT->JWTOptions->Payload->sub = "1234567890";
JWT->JWTOptions->Payload->iat = DateTimeToUnix(Now());
ShowMessage(JWT->Sign());
void __fastcall TForm1::OAuth2AccessToken(TObject *Sender,
const UnicodeString Access_Token, const UnicodeString Token_Type,
const UnicodeString Expires_In, const UnicodeString Refresh_Token,
const UnicodeString Scope, const UnicodeString RawParams, bool &Handled)
{
Memo1->Lines->Add("Access token received.");
}
Aynı JWT bileşeni doğrudan bir WebSocket veya HTTP istemcisine eklenir: Client->Authentication->Token->Enabled = true ve Client->Authentication->Token->JWT = JWT'yi ayarlayın, böylece her istek taze bir Bearer token ile gider.
PLATFORMLAR
Saf HTTPS ve İmzalama, Yerel Kitaplık Yok
Hiçbir bileşen, Core çalışma zamanının HTTP istemci yığını ve platformun kripto ilkellerinin ötesinde bir şeye bağımlı değildir; bu yüzden ikisi de Delphi'nin çalıştığı her yerde derlenir ve çalışır.
sgcAuth kendi başına lisanslanır, tek bir geliştirici için €149 fiyatından başlar. Tüm lisanslar tam kaynak kodunu, 1 yıllık güncellemeleri ve 50% ile 70% arasında bir yenileme indirimi içerir: Tek bir paketi yenilediğinizde 50%, iki pakette 60%, üç veya daha fazla pakette 70% indirim uygulanır. sgcAI, sgcMQ, sgcSocial, sgcCustomIndy, sgcAuth, sgcHTTP ve sgcREST ürünlerinin her biri ayrı bir paket sayılır.
Ödeme sayfasında iki kalem listelenir: sıfır ücretlendirilen sgcWebSockets Core çalışma zamanı hakkı ve sgcAuth paketinin kendisi. WebAuthn için sgcCustomIndy otomatik olarak eklenir, zaten sahipseniz kaldırın. Tüm fiyatlandırma ayrıntıları.
3,000+Geliştirici
20+Yıl
761+Bileşen
30+API Entegrasyonu
5Platform
30 Günlük Para İade GarantisiMemnun kalmadınız mı? Satın alımdan sonraki 30 gün içinde tam para iadesi talep edin. İade politikasına bakın
Bir Token Kitaplığı Değil, Kimlik Doğrulama Gönderin
Yerel Delphi ve C++ Builder kodundan OAuth2 ve JWT; çalışma zamanı pakete dahil ve kutuda tam kaynak kodu. All-Access deneme kurulum paketini indirin ve her iki bileşeni bugün bir forma bırakın.
Delphi ve C++ Builder için eksiksiz bir WebRTC medya motoru: sesli ve görüntülü aramalar, veri kanalları ve ekran paylaşımı. sgcWebSockets Enterprise için bir eklenti.
sgcWebSockets Enterprise'ın üzerine kurulduğu özel Indy kitaplığı, bir eklenti olarak paketlenmiştir. WebAuthn için gereklidir, sgcAuth siparişlerine otomatik olarak eklenir.
Delphi ve C++ Builder için genel amaçlı kriptografi kütüphanesi: simetrik ve asimetrik şifreleme, hashing ve kuantum sonrası algoritmalar. sgcWebSockets Standard sürümünden itibaren ücretsiz gelir.