product icon

Configure LastPass Universal Proxy v5.x

    After you have downloaded the LastPass Universal Proxy v5.x docker image, you can configure the settings using command line interface (CLI) to use LDAP, LDAPS or RADIUS protocols for forwarding authentication requests. This must be done as an administrator on a server machine within your infrastructure where the LastPass Universal Proxy v5.x docker image is located.

    Before you begin:
    Important: LastPass Universal Proxy V5.x is incompatible with V4.x. If you are not upgraded to the 5.x version, contact customer support.
    1. Check Set up LastPass Universal Proxy v5.x for more information on downloading LastPass Universal Proxy v5.x.
    2. Create a volume to store the configuration and log files on your host OS. This volume must be mounted into the container on the guest OS. Set the /usr/local/universalproxy/volume path as mount point. For more information about creating a volume, view using volumes.
    About this task:
    Note: This feature requires an account with the LastPass Business + Advanced MFA add-on. How do I upgrade my LastPass Business account with an add-on?
    Important: LastPass Universal Proxy v5.x runs with service user access within the docker container and it does not have root access.
    Note: We recommend to use the CLI tool when configuring Universal Proxy for the first time, as it generates an initial version of the server.properties file.
    1. Open a terminal window based on your OS:
      Operating System Instructions
      Windows Open Command Prompt as an administrator.
      Linux CLI The terminal window is used by default.
      Linux with graphical user interface Open the Terminal app.
      MAC Open the Terminal app.
    2. Tag the docker image with a friendly name by executing the following command:
      docker tag <imageID> <friendlyname>
    3. Execute the following command in the terminal:
      docker run --<containerID> -v <nameofthevolume>:<mountpointonguestOS> -it --rm <dockerimagerepository>:<dockerimagetag> -configurationTool

      Configuration command example:

      docker run --abcdef123456 -v universalproxy:/usr/local/universalproxy/volume -it --rm lastpass/universalproxy:5.0.0 -configurationTool
    4. Follow the instructions for configuring one of the following protocols:
    5. Once configured the server.properties configuration file is created with the settings in the /usr/local/universalproxy/volume/conf directory.

      After each configuration with the CLI tool a new server.properties file is created and the previous configuration is saved in a server.properties_backup_timestamp file.