zowe / docs-site

Documentation for the Zowe project
https://docs.zowe.org/
Creative Commons Attribution 4.0 International
66 stars 132 forks source link

Issue with docs.zowe.org/stable/user-guide/api-mediation/configuration-extender-passtickets/ #3665

Closed codezfire closed 1 week ago

codezfire commented 1 month ago

Description

The setup process for configuring Zowe to utilize PassTickets requires thorough documentation.

Pages to Update

https://docs.zowe.org/stable/user-guide/api-mediation/configuration-extender-passtickets/

Expected behaviour

Additionally, the procedure steps should incorporate these commands and procedure.

  1. Activate the PTKTDATA class, which encompasses all profiles containing PassTicket information, by executing the subsequent command: SETROPTS CLASSACT(PTKTDATA) RACLIST(PTKTDATA)

  2. Specify the application name requiring access through PassTicket for the ZOWE server with the following commands: RDEFINE APPL UACC(NONE) SETROPTS CLASSACT(APPL) SETROPTS GENERIC(PTKTDATA) Here, replace with a 1- to 8-character name designated for the application, usually provided by the site security administrator.

  3. Define a profile for the application by inputting:

    RDEFINE PTKTDATA SSIGNON(()) This links a secured sign-on application key with the application. Replace with the application name defined previously.

  4. Grant a ZOWE user ID access to the application via:

    PERMIT APPLNAME CLASS(APPL) ID() ACCESS(READ) Replace with the permitted user ID.

  5. Enable the Zowe STC ID to utilize the PassTicket generation service through:

    RDEFINE PTKTDATA IRRPTAUTH.. UACC(NONE) PERMIT IRRPTAUTH.. CLASS(PTKTDATA) - ID() ACCESS(UPDATE) Ensure to replace with the application name and with the Zowe STC user ID.

  6. Refresh the PTKTDATA class to activate the modifications by executing:

    SETROPTS RACLIST(APPL) REFRESH SETROPTS RACLIST(PTKTDATA) REFRESH

  7. Validate

    RLIST APPL APPLNAME ALL RLIST PTKTDATA IRRPTAUTH.APPLNAME.* ALL

anaxceron commented 1 month ago

@balhar-jakub @janan07 -- please review

janan07 commented 1 week ago

Closed with https://github.com/zowe/docs-site/pull/3673