yoti 1.6.3 → 1.9.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (84) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +22 -224
  3. data/lib/yoti.rb +54 -1
  4. data/lib/yoti/client.rb +13 -4
  5. data/lib/yoti/configuration.rb +7 -2
  6. data/lib/yoti/data_type/age_verification.rb +1 -1
  7. data/lib/yoti/data_type/base_profile.rb +1 -1
  8. data/lib/yoti/data_type/image.rb +4 -12
  9. data/lib/yoti/data_type/image_jpeg.rb +2 -0
  10. data/lib/yoti/data_type/image_png.rb +2 -0
  11. data/lib/yoti/data_type/media.rb +19 -0
  12. data/lib/yoti/data_type/signed_time_stamp.rb +1 -1
  13. data/lib/yoti/doc_scan/client.rb +187 -0
  14. data/lib/yoti/doc_scan/constants.rb +31 -0
  15. data/lib/yoti/doc_scan/errors.rb +81 -0
  16. data/lib/yoti/doc_scan/session/create/create_session_result.rb +50 -0
  17. data/lib/yoti/doc_scan/session/create/document_filter.rb +31 -0
  18. data/lib/yoti/doc_scan/session/create/document_restrictions_filter.rb +140 -0
  19. data/lib/yoti/doc_scan/session/create/notification_config.rb +142 -0
  20. data/lib/yoti/doc_scan/session/create/orthogonal_restrictions_filter.rb +150 -0
  21. data/lib/yoti/doc_scan/session/create/requested_check.rb +39 -0
  22. data/lib/yoti/doc_scan/session/create/requested_document_authenticity_check.rb +95 -0
  23. data/lib/yoti/doc_scan/session/create/requested_face_match_check.rb +95 -0
  24. data/lib/yoti/doc_scan/session/create/requested_id_document_comparison_check.rb +53 -0
  25. data/lib/yoti/doc_scan/session/create/requested_liveness_check.rb +108 -0
  26. data/lib/yoti/doc_scan/session/create/requested_task.rb +39 -0
  27. data/lib/yoti/doc_scan/session/create/requested_text_extraction_task.rb +116 -0
  28. data/lib/yoti/doc_scan/session/create/required_document.rb +31 -0
  29. data/lib/yoti/doc_scan/session/create/required_id_document.rb +53 -0
  30. data/lib/yoti/doc_scan/session/create/sdk_config.rb +221 -0
  31. data/lib/yoti/doc_scan/session/create/session_specification.rb +221 -0
  32. data/lib/yoti/doc_scan/session/retrieve/authenticity_check_response.rb +12 -0
  33. data/lib/yoti/doc_scan/session/retrieve/breakdown_response.rb +38 -0
  34. data/lib/yoti/doc_scan/session/retrieve/check_response.rb +63 -0
  35. data/lib/yoti/doc_scan/session/retrieve/details_response.rb +28 -0
  36. data/lib/yoti/doc_scan/session/retrieve/document_fields_response.rb +21 -0
  37. data/lib/yoti/doc_scan/session/retrieve/document_id_photo_response.rb +21 -0
  38. data/lib/yoti/doc_scan/session/retrieve/face_map_response.rb +21 -0
  39. data/lib/yoti/doc_scan/session/retrieve/face_match_check_response.rb +12 -0
  40. data/lib/yoti/doc_scan/session/retrieve/frame_response.rb +21 -0
  41. data/lib/yoti/doc_scan/session/retrieve/generated_check_response.rb +28 -0
  42. data/lib/yoti/doc_scan/session/retrieve/generated_media.rb +28 -0
  43. data/lib/yoti/doc_scan/session/retrieve/generated_text_data_check_response.rb +12 -0
  44. data/lib/yoti/doc_scan/session/retrieve/get_session_result.rb +127 -0
  45. data/lib/yoti/doc_scan/session/retrieve/id_document_comparison_check_response.rb +12 -0
  46. data/lib/yoti/doc_scan/session/retrieve/id_document_resource_response.rb +57 -0
  47. data/lib/yoti/doc_scan/session/retrieve/liveness_check_response.rb +12 -0
  48. data/lib/yoti/doc_scan/session/retrieve/liveness_resource_response.rb +24 -0
  49. data/lib/yoti/doc_scan/session/retrieve/media_response.rb +38 -0
  50. data/lib/yoti/doc_scan/session/retrieve/page_response.rb +27 -0
  51. data/lib/yoti/doc_scan/session/retrieve/recommendation_response.rb +34 -0
  52. data/lib/yoti/doc_scan/session/retrieve/report_response.rb +31 -0
  53. data/lib/yoti/doc_scan/session/retrieve/resource_container.rb +50 -0
  54. data/lib/yoti/doc_scan/session/retrieve/resource_response.rb +39 -0
  55. data/lib/yoti/doc_scan/session/retrieve/task_response.rb +87 -0
  56. data/lib/yoti/doc_scan/session/retrieve/text_data_check_response.rb +12 -0
  57. data/lib/yoti/doc_scan/session/retrieve/text_extraction_task_response.rb +18 -0
  58. data/lib/yoti/doc_scan/session/retrieve/zoom_liveness_resource_response.rb +33 -0
  59. data/lib/yoti/doc_scan/support/supported_documents.rb +60 -0
  60. data/lib/yoti/dynamic_share_service/extension/thirdparty_attribute_extension.rb +62 -11
  61. data/lib/yoti/dynamic_share_service/policy/dynamic_policy.rb +84 -22
  62. data/lib/yoti/dynamic_share_service/share_url.rb +28 -33
  63. data/lib/yoti/errors.rb +15 -2
  64. data/lib/yoti/http/aml_check_request.rb +12 -6
  65. data/lib/yoti/http/payloads/aml_address.rb +4 -0
  66. data/lib/yoti/http/payloads/aml_profile.rb +7 -1
  67. data/lib/yoti/http/profile_request.rb +11 -6
  68. data/lib/yoti/http/request.rb +221 -18
  69. data/lib/yoti/http/signed_request.rb +13 -4
  70. data/lib/yoti/protobuf/main.rb +1 -1
  71. data/lib/yoti/ssl.rb +2 -2
  72. data/lib/yoti/util/anchor_processor.rb +1 -1
  73. data/lib/yoti/util/validation.rb +41 -0
  74. data/lib/yoti/version.rb +1 -1
  75. data/yoti.gemspec +19 -9
  76. metadata +60 -67
  77. data/.github/ISSUE_TEMPLATE.md +0 -17
  78. data/.gitignore +0 -39
  79. data/CONTRIBUTING.md +0 -127
  80. data/Guardfile +0 -11
  81. data/Rakefile +0 -49
  82. data/login_flow.png +0 -0
  83. data/rubocop.yml +0 -57
  84. data/yardstick.yml +0 -9
@@ -0,0 +1,12 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Yoti
4
+ module DocScan
5
+ module Session
6
+ module Retrieve
7
+ class AuthenticityCheckResponse < CheckResponse
8
+ end
9
+ end
10
+ end
11
+ end
12
+ end
@@ -0,0 +1,38 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Yoti
4
+ module DocScan
5
+ module Session
6
+ module Retrieve
7
+ class BreakdownResponse
8
+ # @return [String]
9
+ attr_reader :sub_check
10
+
11
+ # @return [String]
12
+ attr_reader :result
13
+
14
+ # @return [Array<DetailsResponse>]
15
+ attr_reader :details
16
+
17
+ #
18
+ # @param [Hash] breakdown
19
+ #
20
+ def initialize(breakdown)
21
+ Validation.assert_is_a(String, breakdown['sub_check'], 'sub_check', true)
22
+ @sub_check = breakdown['sub_check']
23
+
24
+ Validation.assert_is_a(String, breakdown['result'], 'result', true)
25
+ @result = breakdown['result']
26
+
27
+ if breakdown['details'].nil?
28
+ @details = []
29
+ else
30
+ Validation.assert_is_a(Array, breakdown['details'], 'details')
31
+ @details = breakdown['details'].map { |details| DetailsResponse.new(details) }
32
+ end
33
+ end
34
+ end
35
+ end
36
+ end
37
+ end
38
+ end
@@ -0,0 +1,63 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Yoti
4
+ module DocScan
5
+ module Session
6
+ module Retrieve
7
+ class CheckResponse
8
+ # @return [String]
9
+ attr_reader :type
10
+
11
+ # @return [String]
12
+ attr_reader :id
13
+
14
+ # @return [String]
15
+ attr_reader :state
16
+
17
+ # @return [Array<String>]
18
+ attr_reader :resources_used
19
+
20
+ # @return [Array<GeneratedMedia>]
21
+ attr_reader :generated_media
22
+
23
+ # @return [<ReportResponse>]
24
+ attr_reader :report
25
+
26
+ # @return [<DateTime>]
27
+ attr_reader :created
28
+
29
+ # @return [<DateTime>]
30
+ attr_reader :last_updated
31
+
32
+ #
33
+ # @param [Hash] check
34
+ #
35
+ def initialize(check)
36
+ Validation.assert_is_a(String, check['type'], 'type', true)
37
+ @type = check['type']
38
+
39
+ Validation.assert_is_a(String, check['id'], 'id', true)
40
+ @id = check['id']
41
+
42
+ Validation.assert_is_a(String, check['state'], 'state', true)
43
+ @state = check['state']
44
+
45
+ Validation.assert_is_a(Array, check['resources_used'], 'resources_used', true)
46
+ @resources_used = check['resources_used']
47
+
48
+ if check['generated_media'].nil?
49
+ @generated_media = []
50
+ else
51
+ Validation.assert_is_a(Array, check['generated_media'], 'generated_media')
52
+ @generated_media = check['generated_media'].map { |media| GeneratedMedia.new(media) }
53
+ end
54
+
55
+ @report = ReportResponse.new(check['report']) unless check['report'].nil?
56
+ @created = DateTime.parse(check['created']) unless check['created'].nil?
57
+ @last_updated = DateTime.parse(check['last_updated']) unless check['last_updated'].nil?
58
+ end
59
+ end
60
+ end
61
+ end
62
+ end
63
+ end
@@ -0,0 +1,28 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Yoti
4
+ module DocScan
5
+ module Session
6
+ module Retrieve
7
+ class DetailsResponse
8
+ # @return [String]
9
+ attr_reader :name
10
+
11
+ # @return [String]
12
+ attr_reader :value
13
+
14
+ #
15
+ # @param [Hash] details
16
+ #
17
+ def initialize(details)
18
+ Validation.assert_is_a(String, details['name'], 'name', true)
19
+ @name = details['name']
20
+
21
+ Validation.assert_is_a(String, details['value'], 'value', true)
22
+ @value = details['value']
23
+ end
24
+ end
25
+ end
26
+ end
27
+ end
28
+ end
@@ -0,0 +1,21 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Yoti
4
+ module DocScan
5
+ module Session
6
+ module Retrieve
7
+ class DocumentFieldsResponse
8
+ # @return [MediaResponse]
9
+ attr_reader :media
10
+
11
+ #
12
+ # @param [Hash] document_fields
13
+ #
14
+ def initialize(document_fields)
15
+ @media = MediaResponse.new(document_fields['media']) unless document_fields['media'].nil?
16
+ end
17
+ end
18
+ end
19
+ end
20
+ end
21
+ end
@@ -0,0 +1,21 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Yoti
4
+ module DocScan
5
+ module Session
6
+ module Retrieve
7
+ class DocumentIdPhotoResponse
8
+ # @return [MediaResponse]
9
+ attr_reader :media
10
+
11
+ #
12
+ # @param [Hash] document_id_photo
13
+ #
14
+ def initialize(document_id_photo)
15
+ @media = MediaResponse.new(document_id_photo['media']) unless document_id_photo['media'].nil?
16
+ end
17
+ end
18
+ end
19
+ end
20
+ end
21
+ end
@@ -0,0 +1,21 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Yoti
4
+ module DocScan
5
+ module Session
6
+ module Retrieve
7
+ class FaceMapResponse
8
+ # @return [MediaResponse]
9
+ attr_reader :media
10
+
11
+ #
12
+ # @param [Hash] facemap
13
+ #
14
+ def initialize(facemap)
15
+ @media = MediaResponse.new(facemap['media']) unless facemap['media'].nil?
16
+ end
17
+ end
18
+ end
19
+ end
20
+ end
21
+ end
@@ -0,0 +1,12 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Yoti
4
+ module DocScan
5
+ module Session
6
+ module Retrieve
7
+ class FaceMatchCheckResponse < CheckResponse
8
+ end
9
+ end
10
+ end
11
+ end
12
+ end
@@ -0,0 +1,21 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Yoti
4
+ module DocScan
5
+ module Session
6
+ module Retrieve
7
+ class FrameResponse
8
+ # @return [MediaResponse]
9
+ attr_reader :media
10
+
11
+ #
12
+ # @param [Hash] frame
13
+ #
14
+ def initialize(frame)
15
+ @media = MediaResponse.new(frame['media']) unless frame['media'].nil?
16
+ end
17
+ end
18
+ end
19
+ end
20
+ end
21
+ end
@@ -0,0 +1,28 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Yoti
4
+ module DocScan
5
+ module Session
6
+ module Retrieve
7
+ class GeneratedCheckResponse
8
+ # @return [String]
9
+ attr_reader :id
10
+
11
+ # @return [String]
12
+ attr_reader :type
13
+
14
+ #
15
+ # @param [Hash] check
16
+ #
17
+ def initialize(check)
18
+ Validation.assert_is_a(String, check['id'], 'id', true)
19
+ @id = check['id']
20
+
21
+ Validation.assert_is_a(String, check['type'], 'type', true)
22
+ @type = check['type']
23
+ end
24
+ end
25
+ end
26
+ end
27
+ end
28
+ end
@@ -0,0 +1,28 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Yoti
4
+ module DocScan
5
+ module Session
6
+ module Retrieve
7
+ class GeneratedMedia
8
+ # @return [String]
9
+ attr_reader :id
10
+
11
+ # @return [String]
12
+ attr_reader :type
13
+
14
+ #
15
+ # @param [Hash] media
16
+ #
17
+ def initialize(media)
18
+ Validation.assert_is_a(String, media['id'], 'id', true)
19
+ @id = media['id']
20
+
21
+ Validation.assert_is_a(String, media['type'], 'type', true)
22
+ @type = media['type']
23
+ end
24
+ end
25
+ end
26
+ end
27
+ end
28
+ end
@@ -0,0 +1,12 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Yoti
4
+ module DocScan
5
+ module Session
6
+ module Retrieve
7
+ class GeneratedTextDataCheckResponse < GeneratedCheckResponse
8
+ end
9
+ end
10
+ end
11
+ end
12
+ end
@@ -0,0 +1,127 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Yoti
4
+ module DocScan
5
+ module Session
6
+ module Retrieve
7
+ class GetSessionResult
8
+ # @return [Integer]
9
+ attr_reader :client_session_token_ttl
10
+
11
+ # @return [String]
12
+ attr_reader :client_session_token
13
+
14
+ # @return [String]
15
+ attr_reader :session_id
16
+
17
+ # @return [String]
18
+ attr_reader :user_tracking_id
19
+
20
+ # @return [String]
21
+ attr_reader :state
22
+
23
+ # @return [Array<CheckResponse>]
24
+ attr_reader :checks
25
+
26
+ # @return [ResourceContainer]
27
+ attr_reader :resources
28
+
29
+ # @return [DateTime]
30
+ attr_reader :biometric_consent_timestamp
31
+
32
+ #
33
+ # @param [Hash] response
34
+ #
35
+ def initialize(response)
36
+ Validation.assert_is_a(Integer, response['client_session_token_ttl'], 'client_session_token_ttl', true)
37
+ @client_session_token_ttl = response['client_session_token_ttl']
38
+
39
+ Validation.assert_is_a(String, response['session_id'], 'session_id', true)
40
+ @session_id = response['session_id']
41
+
42
+ Validation.assert_is_a(String, response['user_tracking_id'], 'user_tracking_id', true)
43
+ @user_tracking_id = response['user_tracking_id']
44
+
45
+ Validation.assert_is_a(String, response['state'], 'state', true)
46
+ @state = response['state']
47
+
48
+ Validation.assert_is_a(String, response['client_session_token'], 'client_session_token', true)
49
+ @client_session_token = response['client_session_token']
50
+
51
+ if response['checks'].nil?
52
+ @checks = []
53
+ else
54
+ Validation.assert_is_a(Array, response['checks'], 'checks')
55
+ @checks = map_checks(response['checks'])
56
+ end
57
+
58
+ @resources = ResourceContainer.new(response['resources']) unless response['resources'].nil?
59
+
60
+ @biometric_consent_timestamp = DateTime.parse(response['biometric_consent']) unless response['biometric_consent'].nil?
61
+ end
62
+
63
+ #
64
+ # @return [Array<AuthenticityCheckResponse>]
65
+ #
66
+ def authenticity_checks
67
+ @checks.select { |check| check.is_a?(AuthenticityCheckResponse) }
68
+ end
69
+
70
+ #
71
+ # @return [Array<FaceMatchCheckResponse>]
72
+ #
73
+ def face_match_checks
74
+ @checks.select { |check| check.is_a?(FaceMatchCheckResponse) }
75
+ end
76
+
77
+ #
78
+ # @return [Array<TextDataCheckResponse>]
79
+ #
80
+ def text_data_checks
81
+ @checks.select { |check| check.is_a?(TextDataCheckResponse) }
82
+ end
83
+
84
+ #
85
+ # @return [Array<LivenessCheckResponse>]
86
+ #
87
+ def liveness_checks
88
+ @checks.select { |check| check.is_a?(LivenessCheckResponse) }
89
+ end
90
+
91
+ #
92
+ # @return [Array<IdDocumentComparisonCheckResponse>]
93
+ #
94
+ def id_document_comparison_checks
95
+ @checks.select { |check| check.is_a?(IdDocumentComparisonCheckResponse) }
96
+ end
97
+
98
+ private
99
+
100
+ #
101
+ # @param [Array<Hash>] checks
102
+ #
103
+ # @return [Array<CheckResponse>]
104
+ #
105
+ def map_checks(checks)
106
+ checks.map do |check|
107
+ case check['type']
108
+ when Constants::ID_DOCUMENT_AUTHENTICITY
109
+ AuthenticityCheckResponse.new(check)
110
+ when Constants::ID_DOCUMENT_COMPARISON
111
+ IdDocumentComparisonCheckResponse.new(check)
112
+ when Constants::ID_DOCUMENT_FACE_MATCH
113
+ FaceMatchCheckResponse.new(check)
114
+ when Constants::ID_DOCUMENT_TEXT_DATA_CHECK
115
+ TextDataCheckResponse.new(check)
116
+ when Constants::LIVENESS
117
+ LivenessCheckResponse.new(check)
118
+ else
119
+ CheckResponse.new(check)
120
+ end
121
+ end
122
+ end
123
+ end
124
+ end
125
+ end
126
+ end
127
+ end