Wszystko, co robi sgcAuth, rozpisane na dwa komponenty klienckie, typy przyznania uprawnień i roszczenia, które implementują, oraz możliwość WebAuthn, którą pakiet odblokowuje razem z sgcCustomIndy. Każda funkcja działa tak samo w Delphi i C++ Builder, a każda licencja zawiera pełny kod źródłowy.
Pięć typów przyznania uprawnień, jeden komponent
Podpisz, dołącz albo zweryfikuj
Klucze dostępu, przez sgcCustomIndy
Delphi od 7 do 13, C++ Builder
sgcAuth jest samowystarczalny. Jest dostarczany z dołączonym środowiskiem uruchomieniowym sgcWebSockets Core, więc nie jest dodatkiem dla klientów OAuth2 i JWT.
Także wewnątrz sgcWebSockets. Zarówno klient OAuth2, jak i klient JWT są dostarczane także wewnątrz sgcWebSockets od edycji Standard wzwyż. All-Access zawiera wszystko. sgcAuth to pakiet samodzielny dla zespołów, które potrzebują wyłącznie klientów uwierzytelniania.
Dwie strony tego samego problemu, zarejestrowane na stronie palety SGC Auth.
| Komponent | Klasa | Zadanie | Opis |
|---|---|---|---|
| OAuth2 Client | TsgcHTTP_OAuth2_Client | Uzyskaj token | Przepływy Authorization Code, PKCE, Client Credentials, Resource Owner Password i Device Code wobec dowolnego dostawcy OAuth2/OIDC, z wbudowanym lokalnym serwerem przekierowania. |
| JWT Client | TsgcHTTP_JWT_Client | Podpisz token | Buduje, podpisuje i weryfikuje tokeny JSON Web Token, samodzielnie albo jako źródło tokenu Bearer dla TsgcWebSocketClient, TsgcHTTP1Client i TsgcHTTP2Client. |
TsgcHTTP_OAuth2_Client obejmuje OAuth 2.0 (RFC 6749) od początku do końca: uruchamia przepływ, przechwytuje przekierowanie, wymienia kod na token i zarządza tokenem po tym fakcie.
| Możliwość | API | Uwagi |
|---|---|---|
| Authorization Code | OAuth2Options.GrantType := auth2Code | Standardowy przepływ dla zaufanych aplikacji webowych po stronie serwera, które mogą przechowywać sekret klienta. |
| Authorization Code + PKCE | auth2CodePKCE (RFC 7636) | Ten sam przepływ z Proof Key for Code Exchange, dla aplikacji natywnych, mobilnych i jednostronicowych, które nie mogą przechowywać sekretu. |
| Client Credentials | auth2ClientCredentials | Wywołania serwer-serwer bez udziału użytkownika: demony i konta usług. |
| Resource Owner Password | auth2ResourceOwnerPassword | Aplikacja pobiera hasło użytkownika bezpośrednio i wymienia je na token. |
| Device Code | auth2DeviceCode (RFC 8628) | Dla urządzeń o ograniczonych możliwościach wprowadzania danych, smart TV, konsol multimedialnych, IoT: pokazuje kod użytkownika, który osoba wpisuje na drugim urządzeniu. |
| Tożsamość klienta | OAuth2Options.ClientId, ClientSecret, Username, Password | Ustaw zgodnie ze specyfikacją API twojego dostawcy; Username/Password obejmują dostawców wymagających Basic Authentication na punkcie końcowym tokenu. |
| Punkty końcowe dostawcy | AuthorizationServerOptions.AuthURL, TokenURL, Scope, RevocationURL, IntrospectionURL | Adresy URL i lista zakresów opublikowane w dokumentacji OAuth2/OIDC twojego dostawcy. |
| Ustawienia wstępne społecznościowe | TsgcHTTP_OAuth2_Client_Google, TsgcHTTP_OAuth2_Client_Microsoft | Gotowe klasy potomne wstępnie konfigurujące punkty końcowe i zakresy Google oraz Microsoft. |
| Lokalny nasłuch przekierowania | LocalServerOptions.IP, Port, RedirectURL | Mały serwer HTTP uruchamiany przez komponent do odbioru przekierowania kodu autoryzacyjnego; domyślnie port 8080, albo 0 dla losowego portu w aplikacjach desktopowych. |
| Uruchom przepływ | Start, Stop | Start otwiera przeglądarkę systemową (albo wystawia kod urządzenia) i rozpoczyna skonfigurowany typ przyznania uprawnień; Stop przerywa go i zamyka lokalny nasłuch. |
| Odświeżanie | Refresh | Wymienia token odświeżający na nowy token dostępu bez kolejnego przejścia przez przeglądarkę. |
| Unieważnienie i introspekcja | Revoke (RFC 7009), Introspect (RFC 7662) | Unieważnij token albo zapytaj o jego status i metadane u dostawcy. |
| DPoP | DPoPOptions, GenerateDPoPKeyPair, OnDPoPSign | Materiał kluczowy i podpisywanie Demonstrating Proof-of-Possession (RFC 9449), dla dostawców wiążących tokeny z parą kluczy. |
| Transport HTTP | HTTPClientOptions | Konfiguracja TLS i logowania dla wewnętrznego klienta HTTP wysyłającego żądania POST do punktów końcowych tokenu, unieważnienia i introspekcji. |
| Zdarzenia cyklu życia | OnBeforeAuthorizeCode, OnAfterAuthorizeCode, OnBeforeAccessToken, OnAfterAccessToken, OnBeforeRefreshToken, OnAfterRefreshToken | Pary przed/po wokół każdego kroku przepływu. |
| Zdarzenia błędów | OnErrorAccessToken, OnErrorAuthorizeCode, OnErrorRefreshToken, OnErrorRevokeToken, OnErrorIntrospectToken | Po jednym na każdy punkt awarii w przepływie, każde niesie błąd, opis i URI od dostawcy. |
| Zdarzenia Device Code | OnDeviceCode, OnDeviceCodeExpired | Dostarcza kod użytkownika i URI weryfikacyjny do wyświetlenia oraz uruchamia się, jeśli użytkownik nie ukończy autoryzacji na czas. |
TsgcHTTP_JWT_Client implementuje RFC 7519 (JSON Web Token), RFC 7515 (JWS) i RFC 7516 (JWE) poprzez jedną właściwość JWTOptions.
| Możliwość | API | Uwagi |
|---|---|---|
| Nagłówek | JWTOptions.Header.alg, typ, kid | Nagłówek JOSE. alg wybiera jwtHS256/384/512, jwtRS256/384/512 albo jwtES256/384/512; dodatkowe pola przez Header.AddKeyValue. |
| Ładunek / roszczenia | JWTOptions.Payload.iss, sub, aud, exp, nbf, iat, jti | Zarejestrowane roszczenia z RFC 7519; własne roszczenia dodawane są przez Payload.AddKeyValue. |
| Materiał kluczowy do podpisywania | JWTOptions.Algorithms.HS.Secret, RS.PrivateKey, ES.PrivateKey | Wspólny sekret dla HMAC, klucz prywatny w formacie PEM dla RSA lub ECDSA, wybierany przez Header.alg. |
| Automatyczne odświeżanie | JWTOptions.RefreshTokenAfter | Gdy większe od zera, Sign automatycznie odświeża iat i przelicza exp; 0 regeneruje token przy każdym żądaniu. |
| Podpisywanie samodzielne | Sign | Buduje, podpisuje i zwraca zakodowany token (header.payload.signature) jako pojedynczy ciąg, bez potrzeby klienta HTTP czy WebSocket. |
| Dołącz do klienta | Start, Client.Authentication.Token.JWT | Start podpisuje skonfigurowany JWT i dostarcza go jako token Bearer do komponentu nadrzędnego; ustaw go raz na Authentication.Token.JWT, a każde żądanie wychodzi podpisane. |
| Współpracuje z | TsgcWebSocketClient, TsgcHTTP1Client, TsgcHTTP2Client | Każdy z tych trzech akceptuje TsgcHTTP_JWT_Client jako swoje źródło tokenu Bearer przez Authentication.Token. |
| Konfiguracja OpenSSL | JWTOptions.OpenSSL_Options | Wersja API i ścieżka biblioteki używane przez algorytmy RS i ES (APIVersion, LibPath, LibPathCustom, UnixSymLinks). |
WebAuthn jest częścią historii sgcAuth, ale nie jest trzecim zarejestrowanym komponentem w tym pakiecie. Jest obsługiwany przez serwer WebAuthn sgcWebSockets i potrzebuje sgcCustomIndy pod spodem.
| Obszar | Szczegóły |
|---|---|
| Co to jest | W3C Web Authentication Level 2 (WebAuthn): logowanie bezhasłowe kluczami dostępu i kluczami bezpieczeństwa FIDO2, oparte na TsgcWSAPIServer_WebAuthn. |
| Gdzie się znajduje | TsgcWSAPIServer_WebAuthn to komponent serwerowy, część sgcWebSockets Enterprise i All-Access, a nie klient zarejestrowany przez ten pakiet. |
| Czego potrzebuje | Zmodyfikowanej biblioteki Indy, którą sgcCustomIndy dostarcza jako dodatek dla sgcWebSockets Core. |
| Jak jest dodawany | Strona zamówienia dodaje sgcCustomIndy do twojego koszyka automatycznie przy zamawianiu sgcAuth. Posiadasz już licencję? Usuń pozycję przy finalizacji zamówienia, w obu przypadkach bez dodatkowych opłat. |
| Strona kliencka | Aplikacja JavaScript po stronie przeglądarki prowadzi ceremonię WebAuthn; sgcHTML dostarcza gotowy komponent UI logowania WebAuthn, który współpracuje z serwerem. |
Specyfikacje standardowe i te same źródła we wszystkich obsługiwanych kompilatorach.
| Obszar | Szczegóły |
|---|---|
| Standardy OAuth2 | OAuth 2.0 (RFC 6749), PKCE (RFC 7636), Device Authorization Grant (RFC 8628), Token Revocation (RFC 7009), Token Introspection (RFC 7662), DPoP (RFC 9449). |
| Standardy JWT | JSON Web Token (RFC 7519), JSON Web Signature (RFC 7515), JSON Web Encryption (RFC 7516). |
| Standard WebAuthn | Web Authentication Level 2 (W3C), przez serwer WebAuthn sgcWebSockets. |
| Platformy | Oba klienty to zwykłe HTTPS i lokalne podpisywanie, więc każda platforma Delphi jest objęta: Windows Win32/Win64, Linux 64-bit, macOS, iOS i Android. |
| Kompilatory | Delphi i C++ Builder od 7 do 13. |
| Edycje | Klient OAuth2 i klient JWT są dostarczane także wewnątrz sgcWebSockets od edycji Standard wzwyż, a All-Access zawiera wszystko. |
| Licencjonowanie | Produkt samodzielny. Środowisko uruchomieniowe sgcWebSockets Core jest dołączone, a pełny kod źródłowy jest w zestawie. |