Configuració de l'IBM Cognos: configuració d'una passarel·la per habilitar SSO per al Cognos 11

Com configurar una passarel·la per a Cognos 11

Una pregunta que se’ns fa molt sovint és la següent:La passarel·la opcional es converteix mai en un requisit?"

I la resposta és:Sí!"

Un dels escenaris més habituals en què es fa obligatori tenir una configuració de passarel·la opcional és la configuració d’inici de sessió únic (SSO). En aquesta entrada del bloc, explicaré com configurar una passarel·la opcional a Cognos Analytics versions 11.0.2 i 11.0.3. Els que ho han seguit La directriu de configuració de l'IIS es pot trobar aquí. I per fer-ho més fàcil, IBM disposa d’una petita eina que podeu descarregar aquí per automatitzar el procés.

Arquitectura del servidor

IBM Cognos Analytics utilitza una arquitectura de servidor de diversos nivells basada en web que es compon de tres nivells de servidor:

• Nivell web
• Nivell d'aplicació
• Nivell de dades

La comunicació web a IBM Cognos Analytics normalment s’encamina a través del nivell web, que facilita les connexions dels usuaris a les aplicacions d’anàlisi d’IBM Cognos i el component responsable d’això és IBM Cognos Analytics Gateway.

El component IBM Cognos Analytics Gateway es pot instal·lar en un servidor diferent del gestor de contingut o del nivell d'aplicació, i IBM l'anomena instal·lació de passarel·la opcional.

Instal·lació de l’extensió d’encaminament de sol·licitud d’aplicació IIS (ARR)

Utilitzaré IIS 8 (Internet Information Services) per als dos mètodes de configuració de proxy invers. Primer, però, heu d’assegurar-vos que teniu instal·lada l’extensió d’encaminament de sol·licituds (ARR) d’IIS. Aquesta és l'extensió que permet que IIS funcioni com a servidor intermediari invers.

1. En una nova sessió del navegador, introduïu l'adreça següent: http://www.iis.net/downloads/microsoft/application-request-routing i feu clic al botó verd gran "Instal·la aquesta extensió".

2. A continuació, se us demanarà que deseu un fitxer anomenat "ARRv3_0.exe". Deseu-lo en algun lloc del vostre equip i, a continuació, executeu-lo. Un cop l'inici de l'instal·lador, premeu el botó "Accepto", si accepteu els termes i condicions.

3. A continuació, l'instal·lador descarregarà i instal·larà l'extensió ARR. En acabar, feu clic al botó "Finalitzar". Si se us mostra alguna altra pàgina, només heu de sortir de totes.

4. Per assegurar-vos que la vostra extensió s'ha instal·lat correctament, inicieu l'IIS Manager des de les "Eines d'administrador" al Windows. Un cop s'iniciï, feu clic al nom del servidor a la part superior esquerra de la pantalla. A continuació, al panell central de l'IIS, ara hauria de ser visible la funció de reescriptura d'URL.

Ara que heu instal·lat l'extensió ARR, podeu continuar configurant el servidor intermediari invers. Per a això, tot el que heu de fer és seguir un dels mètodes següents, en funció de les vostres necessitats. Nota: iSi el vostre objectiu final és configurar Cognos Analytics perquè utilitzi SSO, procediu al mètode 2.

Configuració del servidor intermediari invers

Mètode 1: configuració de l'extensió IIS i Application Request Routing (ARR). (No per a SSO)

Aquest mètode estableix una manera senzilla de configurar un servidor intermediari invers al servidor de passarel·la opcional mitjançant IIS 8. Aquest mètode és adequat per als usuaris que només intenten configurar una passarel·la externa d’IBM Cognos Analytics on el servidor web, de forma similar a Servidor Hosti que està disponible, està disponible públicament o és externa a un tallafoc.

1.  Obriu el Gestor de serveis d'informació d'Internet (IIS), si encara no el teniu obert. Amplieu l'arbre de navegació al tauler esquerre. A "Llocs", feu clic dret al vostre lloc web i seleccioneu "Afegeix directori virtual". Nota: Si no teniu cap configuració de lloc web, feu clic amb el botó dret a "Lloc web predeterminat" a "Llocs".

2. A "Àlies" introduïu qualsevol nom. Vaig seguir el que va fer IBM i vaig entrar a "CA11". A "Ruta física", aneu a una carpeta buida que hàgiu creat amb aquest propòsit a qualsevol lloc del vostre sistema. Vaig tornar a seguir IBM i vaig assenyalar el meu cap a "C: CA". No us preocupeu per la configuració de la prova ... ni pel botó "Connecta com ..." i feu clic a D'acord. Quan amplieu el lloc web o, en el meu cas, el "lloc web predeterminat", hauríeu de veure el vostre lloc web recentment creat com a carpeta. Veig "CA11".

3. Ara heu de configurar l'URL Rewrite, que és on configureu el servidor intermediari invers per redirigir totes les sol·licituds web des del nivell web fins al nivell d'aplicació. Feu clic al vostre nou directori virtual al tauler esquerre i, a continuació, feu doble clic a "Reescriu URL" situat al centre.

4. Feu clic a "Afegeix regles ..." ubicades a "Accions", al tauler de la dreta.

5. Feu doble clic a "Inversió del servidor intermediari" a la secció "Regles d'entrada i sortida".

6. A la secció "Regles entrants" hauríeu de veure un quadre de text. Introduïu el: / del vostre nivell d'aplicació. Assegureu-vos que està activat l'opció "Activa la descàrrega SSL" i feu clic a D'acord.

7. Ara hauríeu de veure una entrada nova creada a la secció "Regles entrants" de la pàgina "Reescriure URL". Haureu de fer una mica més de feina, però no fins que ho arribeu pas 9. Al tauler de la dreta, feu clic a "Mostra les variables del servidor ...". Feu clic a "Afegeix" i escriviu la variable següent: HTTP_X_BI_PATH. Nota: el valor d'aquesta variable és absolut i no pot estar en cap altre format.

8. Feu clic a "Torna a les regles" situat al tauler dret per sortir d'aquest segment.

9. Ressalteu l'element del servidor intermediari inversa d'entrada que heu creat pas 6i, a continuació, al tauler de la dreta, feu clic a "Edita" situat a "Regles entrants".

10. Desplaceu-vos cap avall fins que vegeu la secció "Variables de servidor" i amplieu-la. A continuació, feu clic al botó "Afegeix".

11. Al quadre de diàleg nou, seleccioneu HTTP_X_BI_PATH al menú desplegable "Nom de la variable de servidor". A "Valor", utilitzeu el nom que heu triat al pas 2 i introduïu-lo en el format següent: / "NOM del pas 2" / bi / v1. Per tant, per a mi això semblaria / CA11 / bi / v1. Feu clic al botó "D'acord" i, a continuació, feu clic a "Aplica" a la secció "Accions". Feu clic a "Torna a les regles".

12. Ara heu acabat de configurar el servidor intermediari invers. Tot el que heu de fer és reiniciar IIS pel node superior superior de l'arbre esquerre i feu clic a "Reinicia" a "Accions" al tauler de la dreta.

13. Per provar la configuració, obriu una sessió del navegador i introduïu el següent: http: // ”web_server”: ”port” / alias / bi /
Tingueu en compte que el signe final "/" després de bi és important i cal que hi sigui. Si les coses es configuren correctament, ara hauríeu de poder veure la pantalla d'inici de sessió de Cognos Analytics.

Mètode 2: IIS i ARR amb la passarel·la del servidor Cognos Analytics (mètode adequat per a SSO)

En aquest mètode, primer instal·laràs IBM Cognos Analytics com a "passarel·la opcional" mitjançant l'instal·lador de l'IBM Cognos Analytics Server i, a continuació, utilitzaràs això per configurar el teu servidor intermediari invers.

1. Inicieu l'executable de l'instal·lador de Cognos. El que tinc té aquest aspecte: ca_srv_win64_11.0.3.xxxxxxx.exe. Això llançarà l'instal·lador de l'IBM Cognos Analytics.

2. Seleccioneu un idioma i feu clic a "Següent". A continuació, seleccioneu "Accepto ..." a la finestra següent i feu clic a "Següent" si esteu bé amb l'acord de llicència.

3. A la finestra següent, seleccioneu una ubicació d'instal·lació per a la passarel·la opcional, doneu un nom a la carpeta i feu clic a "Següent".

4. A la secció "Tipus d'instal·lació", seleccioneu el botó d'opció "Personalitzat" i feu clic a Següent.

5. A la secció "Instal·lació personalitzada", seleccioneu el botó d'opció "Primera instal·lació" i feu clic a Següent.

6. A la secció "Tria components", marqueu la casella de selecció "Passarel·la opcional" i feu clic a Següent.

7. A la secció següent, verifiqueu que tot estigui bé i feu clic a "Instal·la".

8. Aquí s'instal·larà Cognos Analytics i, quan s'acabi, feu clic a "Fet". Ara que teniu instal·lat Cognos Analytics, configureu-lo amb IIS perquè serveixi de servidor intermediari invers.

9. Obriu el gestor de serveis d'informació d'Internet (IIS).

10. Amplieu el node superior a l’arbre esquerre i feu clic amb el botó dret al node “Grups d’aplicacions” i seleccioneu “Afegeix agrupació d’aplicacions ...”

11. Introduïu qualsevol nom al quadre de text "Nom". Vaig seguir IBM i vaig entrar al meu com a "IBM Cognos Analytics". Deixeu la "Versió CLR .Net" i el "Mode de canalització gestionat" tal qual i feu clic a D'acord.

12. Amplieu l'arbre a la part esquerra del gestor IIS i feu clic amb el botó dret al vostre lloc web situat al node "Llocs". No tenia cap configuració de lloc web al meu equip, de manera que acabo de seleccionar "Lloc web predeterminat". Al menú del clic dret, seleccioneu "Afegeix directori virtual ..."

13. A Àlies, introduïu qualsevol nom. Vaig seguir IBM i vaig entrar a CAGATE11. A continuació, feu clic a les el·lipses a sota del "Camí físic" i aneu a la carpeta de contingut web de la ubicació d'instal·lació de Cognos Analytics. Feu clic a D'acord.

14. Amplieu el node del lloc web a l'arbre esquerre (el lloc web predeterminat en el meu cas) i ara hauríeu de veure una carpeta nova amb l'àlies que heu seleccionat al pas anterior. Amplieu-lo i ressalteu la carpeta "bi".

15. Feu doble clic a la icona "Reescriu URL" al tauler central. Això us hauria de portar al tauler "Reescriu URL". Feu clic a "Afegeix regles ..." al tauler dret i feu doble clic a "Inversa el servidor intermediari".

16. A la secció "Regles entrants" hauríeu de veure un quadre de text. Introduïu el següent: "APP_SERVER_HOST": "PORT" / bi. Assegureu-vos que està activat l'opció "Activa la descàrrega SSL" i feu clic a D'acord.

17. Al tauler dret, feu clic a "Visualitza les variables del servidor". Feu clic a Afegeix i escriviu el nom següent: HTTP_X_BI_PATH. Nota: aquest nom de variable no pot tenir cap altre format. Escriviu-lo com veieu a sobre i feu clic a D'acord.

18. Feu clic a "Torna a les regles" situat al tauler dret per sortir d'aquest segment.

19. Ressalteu l'element del proxy invers invers que heu creat al pas 16 i, a continuació, al tauler dret feu clic a "Edita" situat a "Regles d'entrada".

20. Desplaceu-vos cap avall fins que vegeu la secció "Variables de servidor" i amplieu-la. A continuació, feu clic al botó "Afegeix".

21. Al quadre de diàleg nou, seleccioneu HTTP_X_BI_PATH al menú desplegable "Nom de la variable de servidor". Sota el valor, utilitzeu el nom que heu triat al pas 13 i introduïu-lo en el format següent: / ”NAME from step 13 ″ / bi / v1. Per tant, per a mi això semblaria / CAGATE11 / bi / v1. Feu clic a D'acord i feu clic a "Aplica" a la secció "Accions". Feu clic a "Torna a les regles".

Ara heu acabat de configurar el servidor intermediari invers. Tot el que heu de fer és reiniciar IIS pel node superior superior de l'arbre esquerre i feu clic a "Reinicia" a "Accions" al tauler de la dreta.

Configuració de Cognos ISAPI (necessària per a SSO, requereix el mètode 2 anterior)

Després de configurar el servidor intermediari invers, només hi ha un pas més: configurar Cognos ISAPI, que és necessari per a SSO. Els passos següents es mostraran primer com es crea una aplicació IIS per a cgi-bin que assigna els mòduls de passarel·la IBM Cognos Analytics a l'agrupació d'aplicacions que es va crear al mètode 2 anterior. A continuació, us mostraré com configurar la interfície de programació d'aplicacions del servidor d'Internet mitjançant el mòdul ISAPI mitjançant l'assignació de mòduls.

Una cosa important a tenir en compte és que sembla que falten a la documentació d’IBM un parell de passos que difereixen segons si esteu configurat a Cognos 11.0.2 o 11.0.3. Però no us preocupeu, ja que us explicaré com funcionen les coses per a cadascuna d’aquestes versions de Cognos Analytics.

1. De nou al gestor IIS, busqueu el directori virtual que heu creat al mètode 2 (recordeu que per a mi es deia "CAGATE11"), feu clic dret sobre ell i seleccioneu "Afegeix aplicació".

2.  Empleneu els camps amb la informació següent:

      1. Àlies: cgi-bin

      2. Grup d'aplicacions: Feu clic a seleccionar i al menú desplegable seleccioneu "IBM Cognos Analytics" i seleccioneu D'acord.

      3. Camí físic: Ubicació del subdirectori cgi-bin a la instal·lació de la passarel·la Cognos Analytics. Feu clic a D'acord.

3. Amplieu l'arbre de navegació i ressalteu el node cgi-bin situat sota el vostre directori virtual. A continuació, al tauler central feu doble clic a "Assignacions de gestors".

4. Feu clic a "Afegeix assignació de mòduls ..." al tauler de la dreta i proporcioneu la informació següent:

      1. Sol·liciteu el camí: cognosisapi.dll (Nota: aquest valor ha de ser exactament igual que el que estic mostrant aquí)

       2. Mòdul: Seleccioneu IsapiModule al menú desplegable. (Nota: si no podeu localitzar aquest valor, consulteu l'apèndix A d'aquesta guia)

      3. Executable: especifiqueu el camí cap a la vostra cognosisapi.dll. Aquest fitxer es troba a / cgi-bin

      4. Nom: Posa-li qualsevol nom. Vaig tornar a seguir IBM i vaig donar al meu "IBMCOGNOS-ISAPI". Feu clic a D'acord.

5. Apareixerà un quadre de diàleg demanant permís per permetre aquesta nova exempció ISAPI. Feu clic a Sí.

Ara és aquí on la documentació d'IBM deixa de banda algunes coses. Si proveu d'iniciar l'URL següent, pot ser que us rebi un error: http (s): //: //cgi-bin/cognosIsapi.dll? b_action = xts.run & m = portal / main.xts & m_redirect = // bi /

Per resoldre aquest problema, heu de seguir aquests passos:

IBM Cognos Analytics 11.0.2

1. Inicieu la configuració de l'IBM Cognos.

2. Feu clic al node Entorn al tauler esquerre.

3. Cerqueu "URI de despatxador per a la passarel·la" i doneu-li el següent valor del vostre servidor de despatx: http: // "appserver_host": "port" / p2pd / servlet / dispatch / ext

4. A la finestra de configuració de l'IBM Cognos, feu clic a "Desa" i ja heu acabat. (Nota: no feu clic al botó verd "Executar" a la part superior de la finestra de configuració, ja que no serà aplicable a la configuració de la passarel·la opcional.)

5. Reinicieu IIS i proveu una vegada més l'URL anterior i, si tot funciona, hauríeu de rebre la pantalla d'inici de sessió d'Analytics.

IBM Cognos Analytics 11.0.3

1. Inicieu la configuració de l'IBM Cognos.

2. Feu clic al node Entorn al tauler esquerre.

3. Cerqueu "URI de despatxador per a la passarel·la" i doneu-li el següent valor del vostre servidor de despatx: http: // "appserver_host": "port" / p2pd / servlet / dispatch / ext

4. A continuació, localitzeu “Configuration Server” i feu clic al llapis per editar-lo.

5. A la finestra nova, feu clic al botó "Recupera".

6. Proporcioneu la informació d'autenticació al servidor del Gestor de continguts i feu clic a D'acord.

1. Torneu a fer clic a D'acord per desar el nou valor del servidor de configuració.
2. A la finestra de configuració de l'IBM Cognos, feu clic a "Desa" i ja haureu acabat. (Nota: no feu clic al botó verd "Executar" a la part superior de la finestra de configuració, ja que no serà aplicable a la configuració de la passarel·la opcional).
3. Reinicieu IIS i proveu una vegada més l'URL anterior i, si tot funciona, hauríeu de rebre la pantalla d'inici de sessió d'Analytics.

Conclusió

En aquesta guia he explicat com configurar una passarel·la opcional a Cognos Analytics 11.0.2 i 11.0.3. Per a això, us vaig mostrar com configurar un servidor intermediari invers mitjançant un dels dos mètodes següents i us vaig mostrar com configurar Cognos ISAPI que és necessari per a SSO. Espero que us hagi agradat aquest tutorial! Si us plau, deixeu qualsevol pregunta a la secció de comentaris que hi ha a sota d’aquesta entrada al bloc.

Apèndix A

Si no podeu veure el mòdul ISAPI al pas "Afegeix assignació de mòduls" anterior, haureu d'afegir-lo manualment. Seguiu els passos següents per fer-ho:

1. Inicieu programes i funcions a Windows.
2. Feu clic a "Activa o desactiva les funcions de Windows".
3. Aneu a Serveis d’informació a Internet> Serveis web a tot el món> Funcions d’aplicació i desenvolupament. I comproveu les opcions següents: Extensions ISAPI i Filtres ISAPI.
4. Feu clic a Acceptar.
5. Reinicieu IIS.
6. Comproveu i verifiqueu que ara el mòdul ISAPI és una opció a la finestra Afegeix assignació de mòduls.