You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Aug 10, 2021. It is now read-only.
Copy file name to clipboardExpand all lines: README.md
+10-8Lines changed: 10 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,9 +6,7 @@ This gem contains the Yoti strategy for OmniAuth.
6
6
7
7
You should have already installed OmniAuth into your app. If not, read the [OmniAuth README](https://github.com/omniauth/omniauth) to get started.
8
8
9
-
Now sign in into the [Yoti dashboard](https://www.yoti.com/dashboard/login) and create an application. Take note of your Application ID and Yoti client SDK ID because that is what your web application will use to authenticate against the Yoti API. Make sure to set a callback URL and download the pem key.
10
-
11
-
An Ruby on Rails example app that implements the Yoti OmniAuth strategy can be found in [Yoti Web Labs](https://github.com/lampkicking/yoti-web-labs/tree/master/voting-app)
9
+
Now sign in into the [Yoti dashboard](https://www.yoti.com/dashboard/login) and create an application. Take note of your Application ID and Yoti client SDK ID because that is what your web application will use to authenticate against the Yoti API. Make sure to set a callback URL to `YOUR_SITE/auth/yoti/callback`, and download the pem key.
12
10
13
11
## Using This Strategy
14
12
@@ -20,11 +18,15 @@ gem 'omniauth-yoti'
20
18
21
19
And then execute:
22
20
23
-
$ bundle
21
+
```shell
22
+
$ bundle
23
+
```
24
24
25
25
Or install it yourself as:
26
26
27
-
$ gem install omniauth-yoti
27
+
```shell
28
+
$ gem install omniauth-yoti
29
+
```
28
30
29
31
## Configuration
30
32
@@ -44,17 +46,17 @@ end
44
46
45
47
`YOTI_APPLICATION_ID` - found on the *Integrations* settings page, under the Login button section.
46
48
47
-
`YOTI_CLIENT_SDK_ID` - found on the *Integrations* settings page
49
+
`YOTI_CLIENT_SDK_ID` - found on the *Integrations* settings page.
48
50
49
-
`YOTI_KEY_FILE_PATH` - the full path to your security key downloaded from the *Keys* settings page (e.g. /Users/developer/access-security.pem)
51
+
`YOTI_KEY_FILE_PATH` - the full path to your security key downloaded from the *Keys* settings page (e.g. /Users/developer/access-security.pem).
50
52
51
53
If you don't have access to the file system to store the pem file, you can replace `key_file_path` with `key`, that stores a string with the content of the secret key (`key: "-----BEGIN RSA PRIVATE KEY-----\nMIIEp..."`).
52
54
53
55
The configuration values are documented in the [Yoti gem repository](https://github.com/lampkicking/yoti-sdk-server-ruby#configuration).
54
56
55
57
## Authentication
56
58
57
-
A call to `/auth/yoti/callback` will open the Yoti authentication page, and after a sucessful authentication, you will be redirected to the callback URL from your Yoti dasboard. The auth hash will be available in `request.env['omniauth.auth']`:
59
+
A call to `/auth/yoti/callback` will open the Yoti authentication page, and after a successful authentication, you will be redirected to the callback URL from your Yoti dashboard. The auth hash will be available in `request.env['omniauth.auth']`:
0 commit comments