The Foxpass Developer Hub

Welcome to the Foxpass developer hub. You'll find comprehensive guides and documentation to help you start working with Foxpass as quickly as possible, as well as support if you get stuck.

Get Started    API Reference

Ubuntu 18.04

Foxpass LDAP installation for Ubuntu 18.04

Here's how to set up a Linux integration with LDAP, powered by Foxpass.

First, log into Foxpass and do the following:

  1. Note your Base DN on the dashboard page. Copy/paste it somewhere.
  2. Create an API key named 'sshd' on the API keys page. Copy/paste it somewhere.
  3. Create an LDAP Binder account with the name 'linux' on the LDAP binders page. Copy/paste the generated password! It is only displayed once.
  4. Create an LDAP Group with the name 'foxpass-sudo' on the LDAP groups page. Set it to be a 'posix' group. Add yourself to the group.

Fully Automated!

Just download and run this script with sudo:

wget https://raw.githubusercontent.com/foxpass/foxpass-setup/master/linux/ubuntu/18.04/foxpass_setup.py
sudo python3 foxpass_setup.py --base-dn <base_dn> --bind-user <bind_user> --bind-pw <bind_pw> --api-key <api_key>

e.g.

sudo python3 foxpass_setup.py --base-dn dc=example,dc=com --bind-user linux --bind-pw efGHbD3aFq --api-key 5GC3NRI5goRBAGkrlsxzYedg0r8HPAO7

You may have to run sudo apt-get update if the dependencies aren't picked up, and then retry running the setup script.

(Pro tip: Run the script on a fresh Ubuntu image, then create a new base AMI for your company.)

Problems? See our troubleshooting guide here: https://foxpass.readme.io/v1.0/docs/foxpass-linux-debugging

Ubuntu 18.04


Foxpass LDAP installation for Ubuntu 18.04

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.


});