Azure Authentication Installation Instructions

This guide will walk you through all the steps to install the Azure Authentication.

To install the Azure AD add-on:

  1. First get the addon from the portal. You can view all the available addons for your plan here: https://portal.securityroots.com/addons.
  2. Then, unpack the zip file. It should contain some .gem files and a Gemfile.plugins file that you'll need for the installation.
  3. SSH into the box as dradispro
  4. Copy the .gem files to /opt/dradispro/dradispro/shared/addons/cache/ (create the directory if it doesn’t exist)
  5. Copy the .yml files (if any) to /opt/dradispro/dradispro/shared/addons/config/
  6. Copy the .rb files (if any) to /opt/dradispro/dradispro/shared/addons/initializers/
  7. Copy the Gemfile.plugins file to /opt/dradispro/dradispro/shared/addons/ (append the contents if it already exists)
  8. Symlink files:
    $ cd /opt/dradispro/dradispro/current/vendor/cache/
    $ ln -s /opt/dradispro/dradispro/shared/addons/cache/*.gem ./
  9. If you copied over .yml files to /opt/dradispro/dradispro/shared/addons/config/, run the following:
    $ cd /opt/dradispro/dradispro/current/config/
    $ ln -s /opt/dradispro/dradispro/shared/addons/config/*.yml ./
  10. If you copied over .rb files to /opt/dradispro/dradispro/shared/addons/initializers/, run the following:
    $ cd /opt/dradispro/dradispro/current/config/initializers/
    $ ln -s /opt/dradispro/dradispro/shared/addons/initializers/*.rb ./
  11. Install the plugins and compile:
    $ cd /opt/dradispro/dradispro/current/
    $ ln -s /opt/dradispro/dradispro/shared/addons/Gemfile.plugins
    $ RAILS_ENV=production bundle install --local --without development test
    $ RAILS_ENV=production ./bin/rails assets:precompile
  12. Add your credentials to the azure.yml file

    You can get your app_id and tenant_id in your registered Azure application. You can get your app_secret by clicking the 'Certificates & secrets' tab in the Azure application you registered, then click 'New Client Secret'. Then select 'Never' expires. This client secret is never shown again, so make sure you copy it now.

    You can get your admin_group_id in the Groups tab. Any user that belongs to this group will automatically be a Dradis Pro admin when a new user sign in for the first time through Azure SSO.

  13. Re-start the app process:
  14. $ god restart dradispro-unicorn

That should get you up and running with the Azure Authentication Addon. If you're running into issues, please contact our support team and let us know!

Streamline InfoSec Project Delivery

Learn practical tips to reduce the overhead that drags down security assessment delivery with this 5-day course. These proven, innovative, and straightforward techniques will optimize all areas of your next engagement including:

  • Scoping
  • Scheduling
  • Project Planning
  • Delivery
  • Intra-team Collaboration
  • Reporting and much more...

Your email is kept private. We don't do the spam thing.