9.4 Using the DirXML Command Line Utility to Configure Named Passwords

9.4.1 Creating a Named Password in the DirXML Command Line Utility

  1. Run the DirXML Command Line utility.

    For information, see Section 12.0, Using the DirXML Command Line Utility.

  2. Specify your user name and password.

    The following list of options is displayed:

    DirXML commands
    
    1: Start driver
    2: Stop driver
    3: Driver operations...
    4: Driver set operations...
    5: Log events operations...
    6: Get DirXML version
    7: Job operations...
    99: Quit
    
    Enter choice:
    
  3. Specify one of the following:

    • Option 3 for Driver Operations

    • Option 4 for Driver Set Operations

    Option 3 for Driver Operations: If you have specified 3, a numbered list of drivers is displayed. Do the following:

    1. Specify the number for the driver you want to add a Named Password to.

      The following list of options is displayed:

      Select a driver operation for:
      driver_name
      
      1: Start driver
      2: Stop driver
      3: Get driver state
      4: Get driver start option
      5: Set driver start option
      6: Resync driver
      7: Migrate from application into DirXML
      8: Submit XDS command document to driver
      9: Submit XDS event document to driver
      10: Queue event for driver
      11: Check object password
      12: Initialize new driver object
      13: Passwords operations
      14: Cache operations
      99: Exit
      
      Enter choice:
      
    2. Specify 13 for Password Operations.

      The following list of options is displayed.

      Select a password operation
      
      1: Set shim password
      2: Reset shim password
      3: Set Remote Loader password
      4: Clear Remote Loader password
      5: Set named password
      6: Clear named password(s)
      7: List named passwords
      8: Get passwords state
      99: Exit
      
      Enter choice:
      
    3. Specify 5 to set a new Named Password.

      Go to Step 4.

    Option 4 for Driver Set Operations: If you have specified 4, the following numbered list of driver set operations is displayed.

    Select a driver set operation
    
    1: Associate driver set with server
    2: Disassociate driver set from server
    3: Export Identity Manager server public key certificate
    4: Regenerate Identity Manager server keypair
    5: Passwords operations
    6: Get default reciprocal attribute mappings
    7: Regenerate all Identity Manager server keys
    99: Exit
    
    Enter choice:
    

    Do the following:

    1. Specify 5 for Password Operations.

      The following list of options is displayed.

      Select a password operation
      
       1: Set named password
       2: Clear named password(s)
       3: List named passwords
      99: Exit
      
      Enter choice:
      
    2. Specify 1 to set a new Named Password.

      Go to Step 4.

  4. At the following prompt, specify the name by which you want to refer to the Named Password:

    Enter password name:
    
  5. At the following prompt, specify a description of the password:

    Enter password description:
    
  6. At the following prompt, specify the actual password that you want to secure:

    Enter password:
    

    The characters you type for the password are not displayed.

  7. At the following prompt, confirm the password by specifying it again:

    Confirm password:
    

    The password operations menu is displayed.

  8. Specify the 99 option twice to exit the menu and quit the DirXML Command Line utility.

9.4.2 Removing a Named Password in the DirXML Command Line Utility

This option is useful if you no longer need Named Passwords you previously created.

  1. Run the DirXML Command Line utility.

    For information, see Section 12.0, Using the DirXML Command Line Utility.

  2. Specify your user name and password.

    The following list of options is displayed:

    DirXML commands
    
    1: Start driver
    2: Stop driver
    3: Driver operations...
    4: Driver set operations...
    5: Log events operations...
    6: Get DirXML version
    7: Job operations...
    99: Quit
    
    Enter choice:
    
  3. Specify one of the following:

    • Option 3 for Driver Operations

    • Option 4 for Driver Set Operations

    Option 3 for Driver Operations: If you have specified 3, a numbered list of drivers is displayed. Do the following:

    1. Enter the number for the driver you want to remove Named Passwords from.

      The following list of options is displayed:

      Select a driver operation for:
      driver_name
      
      1: Start driver
      2: Stop driver
      3: Get driver state
      4: Get driver start option
      5: Set driver start option
      6: Resync driver
      7: Migrate from application into DirXML
      8: Submit XDS command document to driver
      9: Submit XDS event document to driver
      10: Queue event for driver
      11: Check object password
      12: Initialize new driver object
      13: Passwords operations
      14: Cache operations
      99: Exit
      
      Enter choice:
      
    2. Specify 13 for Password Operations.

      The following list of options is displayed:

      Select a password operation
      
      1: Set shim password
      2: Reset shim password
      3: Set Remote Loader password
      4: Clear Remote Loader password
      5: Set named password
      6: Clear named password(s)
      7: List named passwords
      8: Get passwords state
      99: Exit
      
      Enter choice:
      
    3. (Optional) Specify 7 to see the list of existing Named Passwords.

      This helps you to make sure that you are removing the correct password.

    4. Specify 6 to remove one or more Named Passwords.

    5. Go to Step 4.

    Option 4 for Driver Set Operations: If you have specified 4, the following numbered list of driver set operations is displayed.

    Select a driver set operation
    
    1: Associate driver set with server
    2: Disassociate driver set from server
    3: Export Identity Manager server public key certificate
    4: Regenerate Identity Manager server keypair
    5: Passwords operations
    6: Get default reciprocal attribute mappings
    7: Regenerate all Identity Manager server keys
    99: Exit
    
    Enter choice:
    

    Do the following:

    1. Specify 5 for Password Operations.

      The following list of options is displayed.

      Select a password operation
      
      1: Set named password
      2: Clear named password(s)
      3: List named passwords
      99: Exit
      
      Enter choice:
      
    2. (Optional) Specify 3 to see the list of existing Named Passwords.

      This helps you to make sure that you are removing the correct password.

    3. Specify 2 to remove one or more Named Passwords.

    4. Go to Step 4.

  4. At the following prompt, enter No to remove a single Named Password:

    Do you want to clear all named passwords? (yes/no):
    
  5. At the following prompt, enter the name of the Named Password you want to remove:

    Enter password name:
    

    The password operations menu is displayed.

  6. (Optional) Specify the appropriate number to see the list of existing Named Passwords.

    This step helps you to verify that you have removed the correct password.

  7. Specify the 99 option twice to exit the menu and quit the DirXML Command Line utility.