PH50445: ADD CAMIDENTITY TO THE AVAILABLE COLUMN HEADERS FOR CSV USER IMPORT WITHIN THE PRODUCT DOCUMENTATION

APAR status

• Closed as documentation error.

Error description

• Not everyone uses the default templates when creating an OIDC
  namespace. The default templates uses 'email' as the unique
  identifier. If one decides to use a generic template and use
  another claim (e.g. 'upn'), then the 'email' header within the
  CSV user import will fail. Unfortunately, no errors are
  displayed to the users however here is what's recorded in the
  cognosserver.log:
  
  [cognosserver.log]
  - CAMID property value is null. Cannot create Account
  objectv1/users is in error: 500
  - CM-REQ-4049 An error occurred while accessing a security
  system.
  - /v1/users account-service 3871 Request URL:
  /account-service/v1/users
  Response status: 500
  Details:
  {"errors":[{"code":"","level":"error","message":"ADMIN-GEN-0001
  Internal
  error"},{"severity":"error","code":"cmNameSpaceQueryErr","level"
  :"error","messages":["CM-REQ-4049 An error occurred while
  accessing a security system.","Exception occurred:
  java.lang.NullPointerException"],"errorCode":"cmNameSpaceQueryEr
  r","message":"CM-REQ-4049 An error occurred while accessing a
  security system."
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * ca users                                                     *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * Client needs to use 'camIdentity' header within the CSV user *
  * import file rather than 'email'.                             *
  * This needs to be documented properly in our official         *
  * documentation.                                               *
  * https://www.ibm.com/docs/en/cognos-analytics/11.2.0?topic=na *
  * mespaces-creating-csv-file-containing-user-account-informati *
  * on                                                           *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

•  I updated the topic "Creating a .csv file containing user
  account information" and replaced email with camIdentity. I also
  replaced the camIdentity values in the example.
  See
  https://www.ibm.com/docs/en/cognos-analytics/11.2.0?topic=namesp
  aces-creating-csv-file-containing-user-account-information
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

Applicable component levels