Skip to content

Latest commit

 

History

History
69 lines (40 loc) · 3.47 KB

DEVELOPMENT.md

File metadata and controls

69 lines (40 loc) · 3.47 KB
Raw

Development

This software is provided as is under MIT license.

It may contain bugs and does not work in all possible corner cases.

I have access to developer accounts on OneLogin and Auth0. There is no usable, permanent free tier on Okta, so the Okta support has fallen behind (it should be functional but not all features may be supported).

(C) 2020, 2021 Henning Schmiedehausen

Building

As with most golang software, building is straightforward:

$ git clone git@github.com:hgschmie/ofa
$ cd ofa
$ go install

How it works

ofa uses user login and password information (stored in keychain) to create an access token using an IdP.

It then exchanges this token for a SAML 2.0 assertion which contains the necessary information for AWS (roles, session time).

The code actually parses the SAML 2.0 assertion (it is a base64-encoded XML document) to allow role selection.

It then uses the AWS STS AssumeRoleWithSAMLRequest API call to authenticate and create static credentials which are written into the shared credential file.

Why SAML (and not xxx?)

Mostly because the tool that ofa replaces also uses SAML and IdP/SAML integration was uses to authenticate users in the environments where I worked before.

There is no fundamental reason why this tool could not expanded to support e.g. OpenID besides "no one has asked for it and I don't need it right now".

How to help as a developer / user:

Use the tool! If you are using AWS with Okta or OneLogin, it should work out of the box.

Bug reports, feedback, pull requests are welcome, please use the github issue tracker to report them.

At this point, the tool is good enough for me to use so I will only add new features if users ask for them or if I need them myself.

I implement what customers and myself need; this used to be Okta in the past and OneLogin now.

If you work for an IdP vendor

Feel free to reach out to me to get your service supported by ofa.

  • If you work for Okta:
    • I am lacking a working account that can install applications (the developer accounts don't and the trial accounts expire and I don't want to play catchup all the time).
    • No one could tell me whether parsing a HTML page is really the only way to get at the SAML Assertion with an access token. I found similar code in other tools but it seems less than ideal.
  • If you work for Auth0:
  • If you work for OneLogin:
    • How about fixing the "Deny does nothing" bug (CS0298380)? :-)

NOTE ABOUT MACOS CODE SIGNING

ofa release binaries for MacOS are (for now) not signed. Starting with MacOS 10.15, MacOS will complain (and refuse to open the binary). Go to "Security & Privacy" in preferences, choose the "General" tab and click on "Allow anyway" the first time that this happens. Afterwards, ofa runs normally. See macOS Catalina error: [...] the developer cannot be verified for more details.

I currently have no way to sign the released binaries for MacOS and I have no desire to shell out money for developer tools unless I use them all the time.