Documentation and SupportDocumentation and Support

Building a forms based authentication provider

Server extensibility is deprecated and no longer maintained.

Some of you may have implemented an extension for Octopus Server, we would be interested in understanding your requirements better so that we can work towards resolving missing capabilities. Contact us via to let us know if this will affect your instance.

All Forms based providers share the Username/Password/Remember Me UI shipping with the Octopus Deploy UI. To participate as a Forms based authentication provider you must:

  • Host an API endpoint that:
    • expects a Http POST of a LoginCommand object.
    • returns a JSON representation of an IUser and a cookie, as returned by a call to IAuthCookieCreator.CreateAuthCookie.
  • Implement the IAuthenticationProvider interface and have:
    • GetAuthenticationProviderElement return an element with:
      • a Name.
      • FormsLoginEnabled = true.
      • Links containing path to the API from above.
    • GetAuthenticationUrls return the same API url (which is used to add APIs to an allow list when in MaintenanceMode etc).
  • Implement whatever configuration storage you require.

The Octopus Deploy UsernamePasswordAuthenticaionProvider on GitHub provides a good reference point.

Help us continuously improve

Please let us know if you have any feedback about this page.

Send feedback

Last updated Sunday, January 1, 2023