Skip to content

Commit

Permalink
Update Okta Connector to use latest UI (gravitational#3884)
Browse files Browse the repository at this point in the history
* Update Okta Connector to use latest UI

* Move Screenshots
  • Loading branch information
benarent authored Jun 25, 2020
1 parent d326010 commit cdd305d
Show file tree
Hide file tree
Showing 14 changed files with 24 additions and 35 deletions.
59 changes: 24 additions & 35 deletions docs/4.3/enterprise/sso/ssh_okta.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,19 +29,11 @@ auth_service:
## Configure Okta
First, create a SAML 2.0 Web App in Okta configuration section
![Switch to classic UI](../../img/okta-saml-0.png)
![Create APP](../../img/okta-saml-1.png)
![Create APP name](../../img/okta-saml-2.png)
#### 1. Switch to Classic UI
![Switch to classic UI](../../img/sso/okta/switch-to-classic.gif)
**Create Groups**
We are going to create two groups: "okta-dev" and "okta-admin":
![Create Group Devs](../../img/okta-saml-2.1.png)
...and the admin:
![Create Group Devs](../../img/okta-saml-2.2.png)
#### 2. Create a new SAML 2.0 App
![Create APP](../../img/sso/okta/okta-saml-1.png)
### Configure the App
Expand All @@ -60,50 +52,47 @@ GROUP ATTRIBUTE STATEMENTS
- Name: `groups` | Name format: `Unspecified`
- Filter: `Matches regex` | `.*`

![Configure APP](../../img/okta-saml-3.png)
![Configure APP](../../img/sso/okta/setup-redirection.png)

#### Note: RegEx requires `.*`
![Configure APP](../../img/sso/okta/regex.png)

!!! tip "Important"
!!! tip "tip"

Notice that we have set "NameID" to the email format and mapped the groups with
a wildcard regex in the Group Attribute statements. We have also set the "Audience"
and SSO URL to the same value.

### Assign Groups
### Create & Assign Groups

**Create Groups**

We are going to create two groups: "okta-dev" and "okta-admin":

![Create Group Devs](../../img/sso/okta/okta-saml-2.1.png)

...and the admin:

![Create Group Devs](../../img/sso/okta/okta-saml-2.2.png)

Assign groups and people to your SAML app:

![Configure APP](../../img/okta-saml-3.1.png)
![Configure APP](../../img/sso/okta/okta-saml-3.1.png)

Make sure to download the metadata in the form of an XML document. It will be used it to
configure a Teleport connector:

![Download metadata](../../img/okta-saml-4.png)
![Download metadata](../../img/sso/okta/okta-saml-4.png)


## Create a SAML Connector

Now, create a SAML connector [resource](../../admin-guide.md#resources):

```yaml
# okta-connector.yaml
kind: saml
version: v2
metadata:
name: OktaSAML
spec:
# display allows to set the caption of the "login" button
# in the Web interface
display: "Okta SSO"
acs: https://teleport-proxy.example.com:3080/v1/webapi/saml/acs
attributes_to_roles:
- {name: "groups", value: "okta-admin", roles: ["admin"]}
- {name: "groups", value: "okta-dev", roles: ["dev"]}
entity_descriptor: |
<paste SAML XML contents here>
{!examples/resources/saml-connector.yaml!}
```


Create the connector using `tctl` tool:

```bsh
Expand Down Expand Up @@ -199,4 +188,4 @@ $ sudo journalctl -fu teleport
```

If you wish to increase the verbosity of Teleport's syslog, you can pass
`--debug` flag to `teleport start` command.
`--debug` flag to `teleport start` command.
Binary file added docs/4.3/img/sso/okta/obtain-okta-xml.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
Binary file added docs/4.3/img/sso/okta/regex.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/4.3/img/sso/okta/setup-redirection.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/4.3/img/sso/okta/switch-to-classic.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit cdd305d

Please sign in to comment.