castle-rb 1.2.11 → 1.2.12

Sign up to get free protection for your applications and to get access to all the features.
Files changed (4) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +3 -64
  3. data/lib/castle-rb/version.rb +1 -1
  4. metadata +2 -2
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: ba0f2b39431a260b85e4466f76901325b5c23726
4
- data.tar.gz: c08ad55dd0965329595500f61b309dade6be0448
3
+ metadata.gz: 31540e9160fdebfa32408ff4eb628d66735a44a9
4
+ data.tar.gz: 86de8e3b76a4cfe72541a9932081bd42af13ab1e
5
5
  SHA512:
6
- metadata.gz: f1fd3a088e41699773103700b66f76f5db17f659f0b125a7c855461f06dee6c914781bab11564724b0b3a9cfd81a92817dd71ec8210f8218046cba1bc67962c1
7
- data.tar.gz: 24b821b597b5d660c33ae72b7e0a04419be415d8c7d15aa6c55f9d7ad5187edc5f34c1e035f36d5b8c772de5996593c20a43f04e4e770f136fdc888d53813ed6
6
+ metadata.gz: 296f0c509c04e4f671ec62dac7329b972d494342437247875bcf76cacdf0e27c5f04da61017bcfadc18b8f98898423f0b807fcd35eb1f2af4187d0ead6506a0f
7
+ data.tar.gz: 063acc0eb147a34c4b37a0fd3b3e69cbd52f3ed79bd5c80babb2f5ed28d7278be451e7a8162500f2b42d5df98b270923f8cd0bf611d9ef93a80170fa608160c2
data/README.md CHANGED
@@ -21,72 +21,11 @@ Load and configure the library with your Castle API secret in an initializer or
21
21
  Castle.api_secret = 'YOUR_API_SECRET'
22
22
  ```
23
23
 
24
- A Castle client instance will automatically be made available as `castle` in your Rails, Sinatra or Padrino controllers.
24
+ A Castle client instance will be made available as `castle` in your Rails, Sinatra or Padrino controllers. The client will automatically configure the [request context](https://api.castle.io/docs#request-context) for each request.
25
25
 
26
- ## Identifying users
26
+ ## Documentation
27
27
 
28
- Call `identify` when a user logs in or updates their information.
29
-
30
- ```ruby
31
- castle.identify(user.id, {
32
- created_at: user.created_at,
33
- email: user.email,
34
- name: user.name,
35
- custom_attributes: {
36
- company_name: 'Acme',
37
- age: 28
38
- }
39
- })
40
- ```
41
-
42
- Read more about the available fields in the [API docs](https://api.castle.io/docs#users).
43
-
44
- ## Tracking events
45
-
46
- `track` lets you record the security-related actions your users perform. The more actions you track, the more accurate Castle is in identifying fraudsters.
47
-
48
- Event names and detail properties that have semantic meaning are prefixed `$`, and we handle them in special ways.
49
-
50
- When you have access to a **logged in user**, set `user_id` to the same user identifier as when you initiated Castle.js.
51
-
52
- ```ruby
53
- castle.track(
54
- name: '$login.succeeded',
55
- user_id: user.id)
56
- ```
57
-
58
- When you **don't** have access to a logged in user just omit `user_id`, typically when tracking `$login.failed` and `$password_reset.requested`. Instead, whenever you have access to the user-submitted form value, add this to the event details as `$login`.
59
-
60
- ```ruby
61
- castle.track(
62
- name: '$login.failed',
63
- details: {
64
- '$login' => 'johan@castle.io'
65
- })
66
- ```
67
-
68
- ### Supported events
69
-
70
- - `$login.succeeded`: Record when a user attempts to log in.
71
- - `$login.failed`: Record when a user logs out.
72
- - `$logout.succeeded`: Record when a user logs out.
73
- - `$registration.succeeded`: Capture account creation, both when a user signs up as well as when created manually by an administrator.
74
- - `$registration.failed`: Record when an account failed to be created.
75
- - `$email_change.requested`: An attempt was made to change a user’s email.
76
- - `$email_change.succeeded`: The user completed all of the steps in the email address change process and the email was successfully changed.
77
- - `$email_change.failed`: Use to record when a user failed to change their email address.
78
- - `$challenge.requested`: Record when a user is prompted with additional verification, such as two-factor authentication or a captcha.
79
- - `$challenge.succeeded`: Record when additional verification was successful.
80
- - `$challenge.failed`: Record when additional verification failed.
81
- - `$password_reset.requested`: An attempt was made to reset a user’s password.
82
- - `$password_reset.succeeded`: The user completed all of the steps in the password reset process and the password was successfully reset. Password resets **do not** required knowledge of the current password.
83
- - `$password_reset.failed`: Use to record when a user failed to reset their password.
84
- - `$password_change.succeeded`: Use to record when a user changed their password. This event is only logged when users change their **own** password.
85
- - `$password_change.failed`: Use to record when a user failed to change their password.
86
-
87
- ### Supported detail properties
88
-
89
- - `$login`: The submitted email or username from when the user attempted to log in or reset their password. Useful when there is no `user_id` available.
28
+ [Official Castle docs](https://castle.io/docs)
90
29
 
91
30
  ## Exceptions
92
31
 
@@ -1,3 +1,3 @@
1
1
  module Castle
2
- VERSION = "1.2.11"
2
+ VERSION = "1.2.12"
3
3
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: castle-rb
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.2.11
4
+ version: 1.2.12
5
5
  platform: ruby
6
6
  authors:
7
7
  - Johan Brissmyr
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2016-01-19 00:00:00.000000000 Z
11
+ date: 2016-02-06 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: her