Configurare NetIQ Access Manager

È possibile configurare NetIQ Access Manager 3.2 e versioni successive come provider di identità (IDP) per account di accesso aziendali in Portal for ArcGIS. Il processo di configurazione comporta due passaggi principali: la registrazione del provider di identità aziendale con Portal for ArcGIS e la registrazione di Portal for ArcGIS con il provider di identità aziendale.

Se si desidera, è possibile specificare nel portale i metadati sui gruppi aziendali nell'archivio identità. In questo modo nel portale è possibile creare gruppi che sfruttano i gruppi aziendali esistenti nell'archivio identità. Quando i membri accedono al portale, l'accesso a contenuti, elementi e dati è controllato tramite le regole di appartenenza definite nel gruppo aziendale. Se non si specificano i metadati necessari del gruppo aziendale, sarà comunque possibile creare gruppi. Tuttavia le regole di appartenenza verranno controllate da Portal for ArcGIS, non dall'archivio identità.

Informazioni obbligatorie

Con Portal for ArcGIS gli utenti che accedono con gli account aziendali devono ricevere specifiche informazioni sugli attributi dal provider di identità. NameID è un attributo obbligatorio che deve essere inviato dal provider di identità nella risposta SAML per consentire il funzionamento della federazione con Portal for ArcGIS. Quando un utente esegue l'accesso da IDP, Portal for ArcGIS crea un nuovo utente con il nome utente NameID nel proprio archivio utenti. Per il valore inviato dall'attributo NameID sono consentiti solo caratteri alfanumerici, _ (carattere di sottolineatura). (punto) e @ (chiocciola). Qualsiasi altro carattere verrà sostituito da caratteri di sottolineatura nel nome utente creato da Portal for ArcGIS.

Portal for ArcGIS supporta il flusso in ingresso degli attributi givenName e email address dell'account aziendale dal provider di identità aziendale. Quando un utente effettua l'accesso utilizzando un account aziendale e Portal for ArcGIS riceve attributi con i nomi givenname e email o mail (senza distinzione tra maiuscolo e minuscolo), Portal for ArcGIS inserisce il nome completo e l'indirizzo e-mail dell'account utente con i valori ricevuti dal provider di identità. Si consiglia di passare l'email address ottenuto dal provider di identità aziendale per consentire all'utente di ricevere notifiche.

registrazione di NetIQ Access Manager come provider di identità aziendale con Portal for ArcGIS

1. Accedere al Portale Web come amministratore dell'organizzazione e fare clic su La mia organizzazione > Modifica impostazioni > Sicurezza.
2. Nella sezione Accessi aziendali fare clic sul pulsante Imposta provider di identità ed immettere il nome dell'organizzazione nella finestra che viene visualizzata, ad esempio City of Redlands. Quando gli utenti accedono al sito web del portale, questo testo viene visualizzato come parte integrante dell'opzione di accesso SAML, ad esempio Con l'account City of Redlands.

   Nota:

   È possibile registrare un provider di identità aziendale per il portale.

3. Scegliere se gli utenti potranno iscriversi all'organizzazione Automaticamente o Dopo aver aggiunto gli account al portale. Se si seleziona la prima opzione, gli utenti potranno accedere all'organizzazione con l'account di accesso aziendale senza alcun intervento da parte di un amministratore. L'account viene registrato automaticamente con l'organizzazione al primo accesso. Con la seconda opzione è invece necessario che l'amministratore registri gli account necessari con l'organizzazione usando un'utilità da riga di comando o lo script Python di esempio. Una volta registrati gli account, gli utenti potranno accedere all'organizzazione.

   Suggerimento:

   Si consiglia di designare almeno un account aziendale come amministratore del portale e di abbassare di livello o di eliminare l'account amministratore iniziale. Si consiglia inoltre di disabilitare il pulsante Crea account e la pagina di registrazione (signup.html) del portale Web per impedire agli utenti di creare i propri account. Per istruzioni complete, consultare Configurare un provider di identità conforme a SAML con il portale.

4. Fornire informazioni sui metadati del provider di identità utilizzando una delle tre opzioni seguenti:
   • URL: scegliere questa opzione se l'URL dei metadati di federazione NetIQ Access Manager è accessibile da parte di Portal for ArcGIS. Solitamente l'URL si trova all'indirizzo http(s)://<host>:<port>/nidp/saml2/metadata nel computer in cui è in esecuzione NetIQ Access Manager.

     Nota:

     Se il provider di identità aziendale include un certificato autofirmato, potrebbe verificarsi un errore quando si prova a specificare l'URL HTTPS dei metadati. Questo errore si verifica perché in Portal for ArcGIS non è possibile verificare il certificato autofirmato del provider di identità. In alternativa, utilizzare HTTP nell'URL, una delle opzioni seguenti oppure configurare il provider di identità con un certificato attendibile.

   • File: se l'URL non è accessibile da parte di Portal for ArcGIS, salvare i metadati ottenuti dall'URL precedente come file XML e caricare il file.
   • Parametri: scegliere questa opzione se l'URL o il file non è accessibile. Immettere i valori manualmente e fornire i parametri richiesti: URL di accesso e certificato. Per ottenere questi parametri, contattare l'amministratore di NetIQ Access Manager.
5. Configurare le impostazioni avanzate, laddove applicabile:
   • Crittografare asserzione: selezionare questa opzione se NetIQ Access Manager verrà configurato per crittografare le risposte all'asserzione SAML.
   • Abilita richiesta firmata: selezionare questa opzione per consentire a Portal for ArcGIS di firmare la richiesta di autenticazione SAML inviata a NetIQ Access Manager.
   • Propaga logout a provider di identità: selezionare questa opzione per consentire ad Portal for ArcGIS di utilizzare un URL di disconnessione per disconnettere l'utente da Net IQ Access Manager. Immettere l'URL da utilizzare nell'impostazione URL di disconnessione. Se il provider di identità richiede che l'URL di disconnessione sia firmato, l'opzione Abilita richiesta firmata deve essere selezionata.
   • URL di disconnessione: l'URL del provider di identità viene utilizzato per disconnettere l'utente attualmente connesso. Questo valore viene inserito automaticamente se definito nel file di metadati del provider di identità. È possibile aggiornare questo URL in base alle necessità.
   • ID entità: aggiornare questo valore per utilizzare un nuovo ID entità per identificare in maniera univoca il portale in NetIQ Access Manager.

   Le impostazioni Crittografare asserzione e Abilita richiesta firmata utilizzano il certificato samlcert nell'archivio chiavi del portale. Per utilizzare un nuovo certificato, eliminare il certificato samlcert, creare un nuovo certificato con lo stesso alias (samlcert) seguendo la procedura in Importare un certificato nel portale e riavviare il portale.

6. Se si desidera, specificare nel portale i metadati relativi ai gruppi aziendali nell'archivio identità.
   1. Accedere alla directory di Portal for ArcGIS come amministratore dell'organizzazione. Il formato dell'URL è https://webadaptorhost.domain.com/webadaptorname/portaladmin.
   2. Fare clic su Sicurezza > Configurazione > Aggiorna archivio identità.
   3. Inserire il JSON di configurazione del gruppo nella casella di testo Configurazione archivio gruppo (in formato JSON).

      • Copiare il testo seguente e modificarlo in modo che contenga informazioni specifiche per il proprio sito:

        {
          "type": "LDAP",  "properties": {
            "userPassword": "secret",    "isPasswordEncrypted": "false",    "user": "uid=admin,ou=system",    "ldapURLForUsers": "ldaps://bar2:10636/ou=users,ou=ags,dc=example,dc=com",    "ldapURLForRoles": "ldaps://bar2:10636/dc=example,dc=com",    "usernameAttribute": "cn",    "caseSensitive": "false",    "userSearchAttribute": "cn",    "memberAttributeInRoles": "member",    "rolenameAttribute":"cn"
          }
        }

        Nella maggior parte dei casi, sarà necessario solo modificare i valori per i parametri user, userPassword, ldapURLForUsers e ldapURLForRoles. L'URL di LDAP deve essere fornito dall'amministratore LDAP.

        Nell'esempio precedente, l'URL LDAP fa riferimento agli utenti all'interno di un OU (ou=utenti) specifico. Se gli utenti sono presenti in più OU, l'URL LDAP può fare riferimento a un OU di livello superiore o anche al livello radice se necessario. In questo caso, l'aspetto dell'URL è il seguente:

        "ldapURLForUsers": "ldaps://bar2:10636/dc=example,dc=com",

        L'account utilizzato per il parametro user deve disporre delle autorizzazioni per cercare i nomi dei gruppi nell'organizzazione. Anche se la password viene digitata in testo non crittografato, verrà crittografata quando viene archiviata nella directory di configurazione del portale o visualizzata.

        Se LDAP è configurato in modo da non fare distinzione tra maiuscole e minuscole, impostare il parametro caseSensitive su false.
   4. Una volta completata l'immissione di JSON per la configurazione dell'archivio utenti, fare clic su Aggiorna configurazione per salvare le modifiche e riavviare il portale.

registrazione di Portal for ArcGIS come provider di servizi attendibili con NetIQ Access Manager

1. Configurazione di un set di attributi.

   Per creare un nuovo set di attributi in modo che sia possibile inviare gli attributi a Portal for ArcGIS come parte dell'asserzione SAML dopo l'autenticazione dell'utente, attenersi alla procedura di seguito. Se si dispone in un set di attributi esistente già configurato in NetIQ Access Manager, è possibile utilizzare anche tale set.

   1. Accedere alla console di amministrazione di NetIQ Access Manager. In genere è disponibile all'indirizzo http(s)://<host>:<port>/nps.
   2. Individuare il server delle identità nella console di amministrazione di NetIQ e fare clic sulla scheda Impostazioni condivise. In Set di attributi sono visualizzati tutti i set di attributi già creati. Fare clic su Nuovo per creare un nuovo set di attributi. Immettere Portale in Nome set e fare clic su Avanti.
   3. Definire le mappature attributi ed aggiungerle al set di attributi creato nel passaggio precedente.

      Portal for ArcGIS supporta il flusso in ingresso degli attributi givenName e email address dell'account aziendale dal provider di identità aziendale. Quando un utente effettua l'accesso utilizzando un account di accesso aziendale e Portal for ArcGIS riceve attributi con i nomi givenname e email o mail (senza distinzione tra maiuscolo e minuscolo), Portal for ArcGIS inserisce il nome completo e l'indirizzo e-mail dell'account utente con i valori ricevuti dal provider di identità.

      Si consiglia di passare a Portal for ArcGIS l'indirizzo e-mail ottenuto dal provider di identità aziendale. Questa operazione è utile se l'utente diventa in seguito un amministratore. La disponibilità di un indirizzo e-mail nell'account consente all'utente di ricevere notifiche su eventuali attività amministrative e di inviare ad altri utenti inviti ad iscriversi all'organizzazione.

   Fare clic sul collegamento Nuovo e aggiungere le nuove mappature attributi. Le schermate di seguito mostrano l'aggiunta di mappature attributi per givenName, email address e uid. Invece degli esempi, è possibile scegliere qualsiasi attributo dall'origine di autenticazione.

   

   

   

   Fare clic su Fine nella procedura guidata Crea set di attributi. L'operazione crea un nuovo set di attributi denominato Portale.

2. Per aggiungere Portal for ArcGIS come fornitore attendibile con NetIQ Access Manager, attenersi alla procedura di seguito.
   1. Accedere alla console di amministrazione di NetIQ, scegliere il server delle identità e fare clic sul collegamento Modifica.

      

      Verrà aperta la scheda Generale.

   2. Fare clic sulla scheda SAML 2.0, quindi fare clic su Nuovo > Provider di servizi.

      Nella finestra Provider di servizi si aggiunge Portal for ArcGIS come fornitore di servizi affidabile con NetIQ Access Manager.

   3. Nella procedura guidata Crea provider di servizi affidabile, fare clic su Testo metadati come Origine e incollare i metadati dell'organizzazione Portal for ArcGIS nella casella Testo.

      Per ottenere i metadati dell'organizzazione Portal for ArcGIS, accedere all'organizzazione come amministratore facendo clic sul pulsante Modifica impostazioni, sulla scheda Sicurezza e sul pulsante Ottieni provider di servizi. Salvare i metadati come file XML.

      Fare clic su Avanti e su Fine per completare l'aggiunta del provider di servizi affidabile.
3. Per configurare le proprietà per la federazione Portal for ArcGIS e NetIQ Access Manager attenersi alla seguente procedura.
   1. Nella scheda SAML 2.0, fare clic sul collegamento del provider di servizi sotto Provider di servizi. Verrà aperta la scheda Configurazione. Fare clic sulla scheda Metadati e verificare che i metadati per l'organizzazione Portal for ArcGIS siano corretti.
   2. Fare clic sulla scheda Configurazione per tornare alla sezione Attendibile della configurazione. Selezionare l'opzione Crittografare asserzioni se si sceglie l'impostazione avanzata Crittografare asserzione quando si registra NetIQ Access Manager come provider di identità aziendale con Portal for ArcGIS.
   3. Fare clic sulla scheda Attributi.

      In questo passaggio si aggiunge la mappatura attributi dal set creato in precedenza, in modo che NetIQ Access Manager sia in grado di inviare gli attributi a Portal for ArcGIS nell'asserzione SAML.

      Selezionare il set di attributi definito nel passaggio 2.1 precedente. Dopo avere selezionato il set di attributi, gli attributi definiti nel set sono visualizzati nella scheda Disponibili. Spostare gli attributi givenName e email nella casella Invia con autenticazione.

   4. Fare clic sulla scheda Risposta autenticazione nella scheda Configurazione del provider di servizi e impostare la risposta di autenticazione:

      Fare clic su Post dal menu a discesa Associazione.

      Nella colonna Identificatore nomi, selezionare la casella accanto a Non specificato.

      Nella colonna Predefinito selezionare il pulsante di opzione accanto a Non specificato.

      Nella colonna Valore scegliere Attributo ldap uid.

      Nota:

      È possibile configurare qualsiasi altro attributo unico nel set di attributi dall'origine di autenticazione da inviare come NameID. Il valore di questo parametro verrà utilizzato come nome utente nell'organizzazione.

      Fare clic su Applica.

   5. In Configurazione, fare clic sulla scheda Opzioni e scegliere il contratto di autenticazione utente, ad esempio, Nome/Password - Modulo e fare clic su Applica.
4. Riavviare NetIQ Access Manager individuando il server delle identità e facendo clic sul collegamento Aggiorna tutto.