Prima di iniziare

Devi avere i seguenti prerequisiti:

• Un'istanza del servizio App ID
• Una serie di credenziali del servizio
• NPM versione 4 o superiore
• Node versione 6 o superiore
• Il tuo URI di reindirizzamento impostato nel dashboard del servizio App ID

Provatelo voi stessi utilizzando una semplice applicazione di esempio Node.

Installazione dell'SDK Node.js

1. Utilizzando la riga di comando, passa alla directory che contiene la tua applicazione Node.js.

2. Installa il servizio App ID.

   npm install --save ibmcloud-appid
   

Inizializzazione dell'SDK Node.js

1. Aggiungi le seguenti definizioni require al tuo file server.js.

   const express = require('express');
   const session = require('express-session')
   const passport = require('passport');
   const WebAppStrategy = require("ibmcloud-appid").WebAppStrategy;
   const CALLBACK_URL = "/ibm/cloud/appid/callback";
   

2. Configura la tua applicazione Express per utilizzare il middleware della sessione Express.

   const app = express();
   app.use(session({
      secret: "123456",
      resave: true,
      saveUninitialized: true
   }));
   app.use(passport.initialize());
   app.use(passport.session());
   

   Devi configurare il middleware con l'archivio della sessione appropriato per gli ambienti di produzione. Per ulteriori informazioni, vedere il file express.js.

3. Ottieni le tue credenziali in uno dei seguenti modi.

   • Passando alla scheda Applications del dashboard App ID. Se non hai un'applicazione nell'elenco, puoi fare clic su Add application per crearne una,

   • Effettuando una richiesta POST all'endpoint /management/v4/<tenantId>/applications.

     Formato della richiesta:

     curl -X POST \  https://us-south.appid.cloud.ibm.com/management/v4/39a37f57-a227-4bfe-a044-93b6e6060b61/applications/ \
     -H 'Content-Type: application/json' \
     -H 'Authorization: Bearer <IAMToken>' \
     -d '{"name": "ApplicationName"}'
     

     Risposta di esempio:

     {
     "clientId": "111c22c3-38ea-4de8-b5d4-338744d83b0f",
     "tenantId": "39a37f57-a227-4bfe-a044-93b6e6060b61",
     "secret": "ZmE5ZDQ5ODctMmA1ZS00OGRiLWExZDMtZTA1MjkyZTc4MDB4",
     "name": "ApplicationName",
     "oAuthServerUrl": "https://us-south.appid.cloud.ibm.com/oauth/v4/39a37f57-a227-4bfe-a044-93b6e6060b61"
     }
     

4. Facoltativo: decidi come formattare il tuo URI di reindirizzamento. Il reindirizzamento può essere formattato in due diversi modi. Se non viene fornita nessuna delle seguenti opzioni, l'SDK App ID cerca di recuperare l'indirizzo application_uri dell'applicazione in esecuzione su IBM Cloud e aggiunge un suffisso predefinito /ibm/cloud/appid/callback.

   • Manualmente in un nuovo WebAppStrategy({redirectUri: "...."})
   • Come una variabile di ambiente denominata redirectUri

5. Utilizzando le informazioni ottenute nei passi precedenti, inizializza l'SDK.

   passport.use(new WebAppStrategy({
   tenantId: "<tenantID>",
   clientId: "<clientID>",
   secret: "<secret>",
   oauthServerUrl: "<oauthServerURL>",
   redirectUri: "<appURL>" + CALLBACK_URL
   }));
   

6. Configura passport con la serializzazione e la deserializzazione. Questo passo di configurazione è obbligatorio per la persistenza della sessione autenticata attraverso le richieste HTTP. Per ulteriori informazioni, consultare i documenti del passaporto.

   passport.serializeUser(function(user, cb) {
      cb(null, user);
      });
   passport.deserializeUser(function(obj, cb) {
      cb(null, obj);
      });
   

7. Aggiungi il seguente codice al tuo file server.js per emettere i reindirizzamenti del servizio.

   app.get(CALLBACK_URL, passport.authenticate(WebAppStrategy.STRATEGY_NAME));
   

8. Registra il tuo endpoint protetto aggiungendo il seguente frammento di codice nel tuo file app.js.

   app.get(‘/protected_resource’, passport.authenticate(WebAppStrategy.STRATEGY_NAME), function(req, res) {res.json(req.user); });
   

Per ulteriori informazioni, vedi App ID Node.js GitHub repository.

Prima di iniziare

Devi avere i seguenti prerequisiti:

• Un'istanza del servizio App ID
• Una serie di credenziali del servizio
• Apache Maven 3.5 o superiore
• Java 1.8
• Un'applicazione web Liberty for Java

Provatelo voi stessi utilizzando una semplice applicazione di esempio Liberty for Java.

Installazione dell'SDK Liberty for Java

1. Aggiungi una funzione OpenID Connect al tuo server.xml.

   <featureManager>
      <feature>ssl-1.0</feature>
      <feature>appSecurity-2.0</feature>
      <feature>openidConnectClient-1.0</feature>
   </featureManager>
   

2. Ottieni le tue credenziali in uno di questi due modi.

   • Passando alla scheda Applications del dashboard App ID. Se non ne hai già una, puoi fare clic su Add application per crearne una nuova.

   • Effettuando una richiesta POST all'endpoint /management/v4/<tenantID>/applications.

     Formato della richiesta:

     curl -X POST \  https://us-south.appid.cloud.ibm.com/management/v4/39a37f57-a227-4bfe-a044-93b6e6060b61/applications/ \
     -H 'Content-Type: application/json' \
     -H 'Authorization: Bearer <IAMToken>' \
     -d '{"name": "ApplicationName"}'
     

     Risposta di esempio:

     {
     "clientId": "111c22c3-38ea-4de8-b5d4-338744d83b0f",
     "tenantId": "39a37f57-a227-4bfe-a044-93b6e6060b61",
     "secret": "ZmE5ZDQ5ODctMmA1ZS00OGRiLWExZDMtZTA1MjkyZTc4MDB4",
     "name": "ApplicationName",
     "oAuthServerUrl": "https://us-south.appid.cloud.ibm.com/oauth/v4/39a37f57-a227-4bfe-a044-93b6e6060b61"
     }
     

3. Crea una funzione Open ID Connect Client e definisci i seguenti segnaposto. Utilizza le credenziali del servizio per compilare i segnaposto.

   <openidConnectClient
      clientId='App ID client_ID'
      clientSecret='App ID Secret'
      authorizationEndpointUrl='oauthServerUrl/authorization'
      tokenEndpointUrl='oauthServerUrl/token'
      jwkEndpointUrl='oauthServerUrl/publickeys'
      issuerIdentifier='Changed according to the region'
      tokenEndpointAuthMethod="basic"
      signatureAlgorithm="RS256"
      authFilterid="myAuthFilter"
      trustAliasName="ibm.com"
   >
   

   Variabili dell'elemento OIDC per le applicazioni Liberty for Java

   Componente	Descrizione
   clientID secret oauth-server-url	Completa il passo due per ottenere le tue credenziali del servizio.
   authorizationEndpointURL	Aggiungere /authorization alla fine di oauthServerURL.
   tokenEndpointUrl	Aggiungere /token alla fine di oauthServerURL.
   jwkEndpointUrl	Aggiungere /publickeys alla fine di oauthServerURL.
   issuerIdentifier	L'identificatore dell'emittente ha la seguente forma: <region>>.cloud.ibm.com. Ulteriori informazioni sulle regioni disponibili.
   tokenEndpointAuthMethod	Specificata come "basic".
   signatureAlgorithm	Specificata come "RS256".
   authFilterid	L'elenco delle risorse da proteggere.
   trustAliasName	Il nome del tuo certificato nel tuo truststore.

Inizializzazione dell'SDK Liberty for Java

1. Nel tuo file server.xml, definisci un filtro di autorizzazione per specificare le risorse protette. Se un filtro non è definito, il servizio protegge tutte le risorse.

   <authFilter id="myAuthFilter">
      <requestUrl id="myRequestUrl" urlPattern="/protected_resource" matchType="contains"/>
   </authFilter>
   

2. Definisci il tuo tipo di oggetto speciale come ALL_AUTHENTICATED_USERS.

   <application type="war" id="ProtectedServlet" context-root="/appidSample" location="${server.config.dir}/apps/libertySample-1.0.0.war">
      <application-bnd>
            <security-role name="myrole">
               <special-subject type="ALL_AUTHENTICATED_USERS"/>
            </security-role>
      </application-bnd>
   </application>
   

3. Scaricare il file libertySample-1.0.0.war da GitHub e inserirlo nella cartella apps del server. Ad esempio, se il tuo server è denominato defaultServer, il file war dovrebbe essere posizionato qui target/liberty/wlp/usr/servers/defaultServer/apps/.

4. Configura SSL aggiungendo quanto segue al tuo file server.xml. Devi anche creare un truststore.

      <keyStore id="defaultKeyStore" password="myPassword"/>
      <keyStore id="appidtruststore" password="Liberty" location="${server.config.dir}/mytruststore.jks"/>
      <ssl id="defaultSSLConfig" keyStoreRef="defaultKeyStore" trustStoreRef="appidtruststore"/>
   

Per impostazione predefinita, la configurazione SSL richiede che il truststore sia configurato per OpenID Connect. Per saperne di più sulla configurazione di un client OpenID Connect in Liberty.

Prima di iniziare

Devi avere i seguenti prerequisiti:

• Un'istanza del servizio App ID
• Una serie di credenziali del servizio
• Un progetto Java + Maven
• Apache Maven 3.5 o superiore
• Java 1.8
• Spring Boot 2.0 e Security OAuth 2.0 o superiore

Inizializzazione del framework Spring Boot

1. Aggiungete il seguente codice tra i tag <project> </project> nel vostro file Maven pom.xml.

   <parent>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-parent</artifactId>
      <version>2.0.2.RELEASE</version>
      <relativePath/>
   </parent>
   

2. Aggiungi le seguenti dipendenze al tuo file pom.xml Maven.

   <dependencies>
      <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
      </dependency>
      <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-security</artifactId>
      </dependency>
      <dependency>
            <groupId>org.springframework.security.oauth.boot</groupId>
            <artifactId>spring-security-oauth2-autoconfigure</artifactId>
            <version>2.0.0.RELEASE</version>
      </dependency>
   </dependencies>
   

3. Nello stesso file, includi il plugin Maven.

   <plugin>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-maven-plugin</artifactId>
   </plugin>
   

Inizializzazione di OAuth2

1. Aggiungi le seguenti annotazioni al tuo file Java.

   @SpringBootApplication
   @EnableOAuth2Sso
   

2. Estendi la classe con WebSecurityConfigurerAdapter.

3. Sovrascrivi tutta la configurazione di sicurezza e registra il tuo endpoint protetto.

      @Override
      protected void configure(HttpSecurity http) throws Exception {
         http.authorizeRequests()
                  .antMatchers("/protected_Resource").authenticated()
                  .and().logout().logoutSuccessUrl("/").permitAll();
      }
   

Aggiunta di credenziali

1. Ottieni le tue credenziali in uno dei seguenti modi.

   • Passando alla scheda Applications del dashboard App ID. Se non ne hai già una, puoi fare clic su Add application per crearne una nuova.

   • Effettuando una richiesta POST all'endpoint /management/v4/<tenantID>/applications.

     • Formato della richiesta:

       curl -X POST \  https://us-south.appid.cloud.ibm.com/management/v4/39a37f57-a227-4bfe-a044-93b6e6060b61/applications/ \
       -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer <IAMToken>' \
       -d '{"name": "ApplicationName"}'
       

     • Risposta di esempio:

       {
       "clientId": "111c22c3-38ea-4de8-b5d4-338744d83b0f",
       "tenantId": "39a37f57-a227-4bfe-a044-93b6e6060b61",
       "secret": "ZmE5ZDQ5ODctMmA1ZS00OGRiLWExZDMtZTA1MjkyZTc4MDB4",
       "name": "ApplicationName",
       "oAuthServerUrl": "https://us-south.appid.cloud.ibm.com/oauth/v4/39a37f57-a227-4bfe-a044-93b6e6060b61"
       }
       

2. Aggiungi un file di configurazione application.yml alla directory /springbootsample/src/main/resources/. Puoi completare la tua configurazione con le informazioni dalle tue credenziali del servizio.

   security:
   oauth2:
      client:
      clientId: <clientID>
      clientSecret: <clientSecret>
      accessTokenUri: <oauthServerURL>/token
      userAuthorizationUri: <oauthServerURL>/authorization
      resource:
      userInfoUri: <oauthServerURL>/userinfo