Configura l'autenticazione OAuth2 Gapwalk con Keycloak - Modernizzazione del mainframe AWS
PrerequisitiConfigurazione KeycloakIntegra Keycloak nell'applicazione Gapwalk

AWS Mainframe Modernization Service (Managed Runtime Environment experience) non sarà più aperto a nuovi clienti a partire dal 7 novembre 2025. Se desideri utilizzare il servizio, registrati prima del 7 novembre 2025. Per funzionalità simili a AWS Mainframe Modernization Service (esperienza Managed Runtime Environment), esplora AWS Mainframe Modernization Service (Self-Managed Experience). I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, consulta Modifica della disponibilità della modernizzazione del AWS mainframe.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Configura l'autenticazione OAuth2 Gapwalk con Keycloak

Questo argomento descrive come configurare OAuth2 l'autenticazione per le applicazioni Gapwalk utilizzando Keycloak come provider di identità (IdP). In questo tutorial utilizziamo Keycloak 24.0.0.

Prerequisiti

Configurazione Keycloak

  1. Vai alla dashboard di Keycloak nel tuo browser web. Le credenziali predefinite sono admin/admin. Vai alla barra di navigazione in alto a sinistra e crea un realm con il nomedemo, come mostrato nell'immagine seguente.

    alt_text

  2. Crea un client con il nomeapp-demo.

    User interface for creating a new client in an authentication management system.

    localhost:8080Sostituiscilo con l'indirizzo della tua applicazione Gapwalk

    alt_text
    alt_text

  3. Per rendere segreto il tuo client, scegli Clients, poi app-demo, quindi Credenziali.

    alt_text

  4. Scegli Clienti, quindi Ambiti client, quindi Aggiungi mappatore predefinito. Scegli i ruoli del realm.

    alt_text

  5. Modifica il tuo ruolo di realm con la configurazione mostrata nell'immagine seguente.

    alt_text

  6. Ricorda il Token Claim Name definito. Avrai bisogno di questo valore nella definizione delle impostazioni Gapwalk per la gapwalk-application.security.claimGroupName proprietà.

    alt_text

  7. Scegli i ruoli di Realms e crea 3 ruoli:SUPER_ADMIN, ADMIN e. USER Questi ruoli vengono successivamente mappati su ROLE_SUPER_ADMIN e ROLE_USER dall'applicazione Gapwalk per poter accedere ad alcune chiamate API REST con restrizioni. ROLE_ADMIN

    alt_text

Integra Keycloak nell'applicazione Gapwalk

Modifica il tuo come segue: application-main.yml

gapwalk-application.security: enabled
gapwalk-application.security.identity: oauth
gapwalk-application.security.issuerUri: http://<KEYCLOAK_SERVER_HOSTNAME>/realms/<YOUR_REALM_NAME>
gapwalk-application.security.claimGroupName: "keycloak:groups"

gapwalk-application.security.userAttributeName: "preferred_username"
# Use "username" for cognito, 
#     "preferred_username" for keycloak
#      or any other string
gapwalk-application.security.localhostWhitelistingEnabled: false

spring:
  security:
    oauth2:
      client:
        registration:
          demo:
            client-id: <YOUR_CLIENT_ID>
            client-name: Demo App
            client-secret: <YOUR_CLIENT_SECRET>
            provider: keycloak
            authorization-grant-type: authorization_code
            scope: openid
            redirect-uri: "{baseUrl}/login/oauth2/code/{registrationId}"
        provider:
          keycloak:
            issuer-uri: ${gapwalk-application.security.issuerUri}
            authorization-uri: ${gapwalk-application.security.issuerUri}/protocol/openid-connect/auth
            jwk-set-uri: ${gapwalk-application.security.issuerUri}/protocol/openid-connect/certs
            token-uri: ${gapwalk-application.security.issuerUri}/protocol/openid-connect/token
            user-name-attribute: ${gapwalk-application.security.userAttributeName}
      resourceserver:
        jwt:
          jwk-set-uri: ${gapwalk-application.security.issuerUri}/protocol/openid-connect/certs

Sostituisci <KEYCLOAK_SERVER_HOSTNAME><YOUR_REALM_NAME>,<YOUR_CLIENT_ID>, e <YOUR_CLIENT_SECRET> con il nome host del server Keycloak, il nome dell'area, l'ID cliente e il segreto del cliente.