Authentication with Cognito

[eschwartz]

I want to be able to authenticate as a DCE user (not admin), via an external IDP.

User Flow:

• CLI command initiates auth flow

  $ dce auth
  > Opening a browser to authenticate....
  > Enter Login Code: 

• CLI grabs location of DCE API from dce.yml

  • This config is either populated on running dce system deploy, or manually configured by end user

• CLI opens browser window at https://<dce_api_url>/auth

• /auth uses Cognito JS SDK (client-side) to redirect user to IDP login page*

• IDP prompts user for username/password

• IDP redirects back to /auth endpoint, with ?code= query param

• /auth endpoint converts the ?code= param to a JWT, using Cognito JS SDK**

• /auth endpoint converts the JWT to an STS token, using the Cognito JS SDK**

• /auth endpoint encodes the STS token as base64

• /auth endpoint displays base64 token to user, and copies to clipboard

• User pastes the token back into their CLI prompt

• CLI saves the token to dce.yaml for future use

For future CLI commands...

• CLI decodes STS token, and uses in sigv4 auth to DCE API endpoints
• API Gateways is able to inspect the STS token and associate it with a Cognito identity. API GW includes cognito metadata in API Gateway Event object passed to lambdas***

Other Considerations

• If a CLI user is using AWS CLI creds (eg. from ~/.aws/credentials), they shouldn't need to login via Cognito. They should be able to continue using basic IAM Auth, and be treated as an admin user.

---

* note that /auth endpoint is not yet implemented. Will be completed in main DCE repo ** Alternatively, /auth endpoint could just grab the ?code= param and pass it back to the CLI, and the CLI could do the code->JWT->STS conversion *** ...or so we think. See /leases/auth code for inspecting cognito data in API GW events

---

BONUS POINTS: Auto-Auth

CLI should have a pre-command hook, which authenticates users if they aren't already authenticated.

So, I should be able to run dce leases login, go through my IDP login, and get access to my AWS account. (I don't want to run dce auth and then also dce leases login.

Tasks

For github.com/Optum/dce:

• [x] Add /auth endpoint, with client side Cognito JS SDK code
• [x] Verify that STS tokens from Cognito get passed through into the API GW event, the way we think they do
• [x] Test IRL, with a real IDP
  • Identity any areas where additional configuration is necessary
• [ ] Document how to integrate IDP/Cognito with DCE

For github.com/Optum/dce-cli

• [x] Update dce auth to open /auth endpoint
• [x] dce auth command prompts for code, and saves to dce.yml
• [x] Use API code from dce auth for other CLI commands

[eschwartz]

@joshmarsh is going to drive the github.com/Optum/dce work @eschwartz is going to drive the github.com/Optum/dce-cli work

[joshmarsh]

/auth endpoint encodes the STS token as base64 /auth endpoint displays base64 token to user, and copies to clipboard

@eschwartz , here's an example of the sts creds JSON:

{
   "accessKeyId":"xxx",
   "secretAccessKey":"xxx",
   "sessionToken":"xxx",
   "expireTime":"Wed Nov 20 2019 13:30:13 GMT-0600 (Central Standard Time)"
}