Integracje

Przepisy dla najczęstszych stacków: WordPress, Perfex, Laravel, plus 3rd-party SSO, tryb reseller i porównanie rynkowe.

Integracje

Ta sekcja to praktyczny hub: tu trafisz gdy zdecydowałeś się już na WolfieAuth i chcesz go wpiąć w coś konkretnego. Trzy first-class plugin/package przepisy (WordPress, Perfex, Laravel) siedzą na tej stronie. Trzy siostrzane strony pokrywają szersze wzorce integracji:

• SSO dla apek 3rd-party → — Portainer, Grafana, Argo CD, Proxmox, Gitea, Nextcloud, oauth2-proxy. Wszystko co mówi OIDC albo generic OAuth2 wpina się przez zarejestrowanie jednego OidcClient i wklejenie czterech URL-i.
• Tryb reseller → — gdy twoja downstream apka sama hostuje sub-tenantów. 3-poziomowa polityka fee, custom domeny per-reseller, branding cascade, cascade-suspend, SDK helpery.
• WolfieAuth vs rynek IAM → — uczciwe porównanie przeciw Auth0, Okta, WorkOS, Stytch, FrontEgg, AWS IAM Identity Center i better-auth na B2B-z-B2B / hierarchia / passwordless / prymitywy billingowe.

Wszystkie trzy plugin recipes poniżej zaczynają się tak samo: zarejestruj apkę w panelu admina WolfieAuth, pobierz client_id + client_secret, potem wepnij plugin/paczkę.

WordPress

Instalacja

Pobierz plugin wolfieauth-client z downloads.wolfieguard.com, uploaduj przez Plugins → Add New → Upload, aktywuj. Albo WP-CLI:

wp plugin install https://downloads.wolfieguard.com/wolfieauth-client.zip --activate

Konfiguracja

Settings → WolfieAuth:

Issuer:        https://auth.wolfieguard.com
Client ID:     <twojaorg>-<twojastrona>
Client Secret: <z-panelu-admin>
Scopes:        openid profile email org
Auto-link by email: ON

Plugin auto-rejestruje OIDC callback na /wp-admin/admin-ajax.php?action=wolfieauth_callback. Ustaw ten URL jako Redirect URI w panelu WolfieAuth.

Przycisk login

Dodaj do header.php lub przez shortcode [wolfieauth_login]:

<a href="<?php echo esc_url( admin_url('admin-ajax.php?action=wolfieauth_start') ); ?>">
  🐺 Zaloguj przez WolfieAuth
</a>

Mapowanie ról WolfieAuth → WP

Przy loginie plugin mapuje claims.wolfieauth_role_slug na rolę WP per filter wolfieauth_role_map. Default mapping:

Override przez filter:

add_filter('wolfieauth_role_map', function ($map) {
  $map['billing-admin'] = 'shop_manager';  // WooCommerce role
  return $map;
});

Perfex CRM

Instalacja

Wrzuć moduł wolfieauth_client do application/modules/ i aktywuj przez Setup → Modules.

Konfiguracja

Setup → WolfieAuth:

Issuer:        https://auth.wolfieguard.com
Client ID:     <twojaorg>-<twojperfex>
Client Secret: <z-panelu-admin>
Auto-create staff:    ON
Auto-create contacts: ON

Redirect URI do zarejestrowania w WolfieAuth: https://twojperfex.com/wolfieauth_client/callback

Flow loginu

Moduł zastępuje Perfex login page przyciskiem “Sign in with WolfieAuth”. Bezpośredni login Perfex wciąż działa dla użytkowników bez linkowanego konta WolfieAuth.

Mapowanie ról dla staff z linkowanymi kontami:

Linkowanie istniejących userów Perfex

Gdy Perfex staff z emailem [email protected] pierwszy raz loguje się przez WolfieAuth a w Perfex już istnieje staff o tym email-u, moduł auto-linkuje dwoje przez email zamiast tworzyć duplikat.

Manual provisioning z panelu WolfieAuth

Dla ops userów co chcą stworzyć nowego Perfex staff z poziomu WolfieAuth: idź do /admin/clients/<your-perfex-app-id>#users → + Dodaj usera. Wpisz email, name, rolę, klik Utwórz. Strona Perfex tworzona przez REST API, LinkedAccount linkuje obie strony.

Laravel

Instalacja

composer require wolfieauth/laravel
php artisan vendor:publish --tag=wolfieauth-config
php artisan vendor:publish --tag=wolfieauth-migrations
php artisan migrate

Konfiguracja

.env:

WOLFIEAUTH_ISSUER=https://auth.wolfieguard.com
WOLFIEAUTH_CLIENT_ID=twojorgslug-myapp
WOLFIEAUTH_CLIENT_SECRET=<z-panelu-admin>
WOLFIEAUTH_REDIRECT_URI="${APP_URL}/auth/wolfieauth/callback"

Zarejestruj https://twoja-apka.com/auth/wolfieauth/callback jako Redirect URI w panelu WolfieAuth.

Użycie

Routes auto-rejestrują się:

• GET /auth/wolfieauth/login → redirect do WolfieAuth
• GET /auth/wolfieauth/callback → handle code, zaloguj user-a
• GET /auth/wolfieauth/logout → Laravel + WolfieAuth logout

<a href="{{ route('wolfieauth.login') }}">🐺 Zaloguj przez WolfieAuth</a>

W controllerach / middleware / policies — działa jak standardowy Laravel auth (Auth::check(), Auth::user()).

Events

// EventServiceProvider
protected $listen = [
    \WolfieAuth\Laravel\Events\WolfieAuthUserCreated::class => [
        \App\Listeners\SendWelcomeEmail::class,
    ],
    \WolfieAuth\Laravel\Events\WolfieAuthLoggedIn::class => [
        \App\Listeners\TrackLoginActivity::class,
    ],
];

Oba eventy niosą $user (Twój User model) i raw $claims z /userinfo.

Inne stacki

Dla Express / Django / Rails / Symfony / CakePHP / Go — patrz SDKs dla podobnego setupu. Wzór jest ten sam: zainstaluj SDK, skonfiguruj env, zarejestruj redirect URI, drop “Sign in” button.

Dla dowolnych apek 3rd-party których nie pisałeś (Portainer, Grafana, Argo CD, Proxmox, Gitea, Nextcloud, cokolwiek OIDC-compatible), patrz SSO dla apek 3rd-party — konkretne tabele settings + troubleshooting.

Czytaj dalej

• SSO dla apek 3rd-party — wpięcie Portainer, Grafana, Argo CD, Proxmox, Gitea, Nextcloud
• Tryb reseller — multi-tier B2B-z-B2B dla downstream apek
• WolfieAuth vs rynek IAM — Auth0, Okta, WorkOS, Stytch, FrontEgg, AWS IAM, better-auth
• SSO & Sesje — co dzieje się między klikiem login a render dashboardu
• Plany & Billing — zacznij charge-ować

Ostatnia aktualizacja: 2026-05-02