IBM Verify

IBM Verify

Join this online user group to communicate across Security product users and IBM experts by sharing advice and best practices with peers and staying up to date regarding product enhancements.

 View Only
  • 1.  Incorrectly documented API: Export all Runtime Template Files

    Posted 01/07/20 06:00 AM
    To whom it may concern,

    I realized that in the "Web Services" documentation (Help > Web Services) the API "Export all Runtime Template Files" is incorrectly documented. I am not sure if anyone is aware of that. I've check on both 9.0.6 and 9.0.7 versions, and the information is the same.

    There are 2 mistakes:
    1) The full request url should be: https://{appliance_hostname}/mga/template_files?export=true
    Without the trailing "/" and with complete parameter export=true

    2) No headers should be in the request, except the Authorization header (BA).
    In the documentation it mentions to include the "Accept:application/json"

    I've reconstructed the correct API call from the ibmsecurity Git library, where it is working fine.

    Best,
    Dean


    ------------------------------
    Dean Ivosevic
    ------------------------------


  • 2.  RE: Incorrectly documented API: Export all Runtime Template Files

    Posted 01/07/20 06:08 AM
    Hello Dean,

    Thank you for bringing this to our attention.  I have forwarded to our development team.
    Perhaps someone in support will also create a Tech Note for this (if appropriate).

    I appreciate you taking the time to let us know.

    Jon.

    ------------------------------
    Jon Harry
    Consulting IT Security Specialist
    IBM
    ------------------------------



  • 3.  RE: Incorrectly documented API: Export all Runtime Template Files

    Posted 01/07/20 03:18 PM
    Dean,
     
    Thanks for letting us know about this documentation issue.  The documentation will be corrected in the upcoming ISAM release.
     



    Scott A. Exton
    Senior Software Engineer
    Chief Programmer - IBM Security Access Manager

    IBM Master Inventor


    Phone: 61-7-5552-4008
    E-mail: scotte@au1.ibm.com
    L11 & L7 Seabank
    Southport, QLD 4215
    Australia



    ------Original Message------

    To whom it may concern,

    I realized that in the "Web Services" documentation (Help > Web Services) the API "Export all Runtime Template Files" is incorrectly documented. I am not sure if anyone is aware of that. I've check on both 9.0.6 and 9.0.7 versions, and the information is the same.

    There are 2 mistakes:
    1) The full request url should be: https://{appliance_hostname}/mga/template_files?export=true
    Without the trailing "/" and with complete parameter export=true

    2) No headers should be in the request, except the Authorization header (BA).
    In the documentation it mentions to include the "Accept:application/json"

    I've reconstructed the correct API call from the ibmsecurity Git library, where it is working fine.

    Best,
    Dean


    ------------------------------
    Dean Ivosevic
    ------------------------------