google-cloud-kms 2.2.0 → 2.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: b90768c9f373a6fb3fe7c432c1632721af4e4af01596ddef3bcdc94b4d668521
4
- data.tar.gz: c038c594a6e9c6e06c7e2065ad9fa544585d7423daa6104c51c9d02d397b4927
3
+ metadata.gz: a48e37e84a967b9513c0cbf2f4cb00b75d6fadd16eff1c90f85b2dd2adcdf74c
4
+ data.tar.gz: b6830fba959bfbee8e89b2985fecf9c7ec7a5023114a363f39d1e60b8e31aa43
5
5
  SHA512:
6
- metadata.gz: 7164cf7922e4ddbb008afaed0238d4c6d2b89764e9817ec7c1b65522c654a5218b4a5d19f9fae41049645758afb9325e3b49d887186680c26f711ecf6de3dc70
7
- data.tar.gz: 9e15079040961ac6ac8c991078a758c5a9481465dfc7462bad15272bd06db098864160baae95d7bad3741a255d610bf77fa8bde8f18edba75c84c1564a2cb2b5
6
+ metadata.gz: 85ec030ffd1a8f2652e2267339001e57033ce9b5083744a55139f4ff478802328fda165c2ca32a44a0fc39726fab2a02c95c8df291cfec1f54a123a85227bde9
7
+ data.tar.gz: 1fc67673b776260e471333d5606c70dc22ef96feb3981779a3b65377a9611fae8a5747b61b3bba12f665b82a6ce4ad469ba297197bc772af1aadc045b495e084
data/.yardopts CHANGED
@@ -1,5 +1,5 @@
1
1
  --no-private
2
- --title=Cloud Key Management Service (KMS) API
2
+ --title="Cloud Key Management Service (KMS) API"
3
3
  --exclude _pb\.rb$
4
4
  --markup markdown
5
5
  --markup-provider redcarpet
data/AUTHENTICATION.md CHANGED
@@ -27,7 +27,7 @@ export KMS_CREDENTIALS=path/to/keyfile.json
27
27
  ```ruby
28
28
  require "google/cloud/kms"
29
29
 
30
- client = Google::Cloud::Kms.key_management_service
30
+ client = Google::Cloud::Kms.ekm_service
31
31
  ```
32
32
 
33
33
  ## Credential Lookup
@@ -64,7 +64,7 @@ containers where writing files is difficult or not encouraged.
64
64
 
65
65
  The environment variables that google-cloud-kms
66
66
  checks for credentials are configured on the service Credentials class (such as
67
- `::Google::Cloud::Kms::V1::KeyManagementService::Credentials`):
67
+ `::Google::Cloud::Kms::V1::EkmService::Credentials`):
68
68
 
69
69
  * `KMS_CREDENTIALS` - Path to JSON file, or JSON contents
70
70
  * `KMS_KEYFILE` - Path to JSON file, or JSON contents
@@ -77,7 +77,7 @@ require "google/cloud/kms"
77
77
 
78
78
  ENV["KMS_CREDENTIALS"] = "path/to/keyfile.json"
79
79
 
80
- client = Google::Cloud::Kms.key_management_service
80
+ client = Google::Cloud::Kms.ekm_service
81
81
  ```
82
82
 
83
83
  ### Configuration
@@ -88,7 +88,7 @@ it in an environment variable. Either on an individual client initialization:
88
88
  ```ruby
89
89
  require "google/cloud/kms"
90
90
 
91
- client = Google::Cloud::Kms.key_management_service do |config|
91
+ client = Google::Cloud::Kms.ekm_service do |config|
92
92
  config.credentials = "path/to/keyfile.json"
93
93
  end
94
94
  ```
@@ -102,7 +102,7 @@ Google::Cloud::Kms.configure do |config|
102
102
  config.credentials = "path/to/keyfile.json"
103
103
  end
104
104
 
105
- client = Google::Cloud::Kms.key_management_service
105
+ client = Google::Cloud::Kms.ekm_service
106
106
  ```
107
107
 
108
108
  ### Cloud SDK
@@ -120,15 +120,6 @@ To configure your system for this, simply:
120
120
  **NOTE:** This is _not_ recommended for running in production. The Cloud SDK
121
121
  *should* only be used during development.
122
122
 
123
- [gce-how-to]: https://cloud.google.com/compute/docs/authentication#using
124
- [dev-console]: https://console.cloud.google.com/project
125
-
126
- [enable-apis]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/enable-apis.png
127
-
128
- [create-new-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account.png
129
- [create-new-service-account-existing-keys]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account-existing-keys.png
130
- [reuse-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/reuse-service-account.png
131
-
132
123
  ## Creating a Service Account
133
124
 
134
125
  Google Cloud requires **Service Account Credentials** to
@@ -139,31 +130,22 @@ If you are not running this client within
139
130
  [Google Cloud Platform environments](#google-cloud-platform-environments), you
140
131
  need a Google Developers service account.
141
132
 
142
- 1. Visit the [Google Developers Console][dev-console].
133
+ 1. Visit the [Google Cloud Console](https://console.cloud.google.com/project).
143
134
  2. Create a new project or click on an existing project.
144
- 3. Activate the slide-out navigation tray and select **API Manager**. From
135
+ 3. Activate the menu in the upper left and select **APIs & Services**. From
145
136
  here, you will enable the APIs that your application requires.
146
137
 
147
- ![Enable the APIs that your application requires][enable-apis]
148
-
149
138
  *Note: You may need to enable billing in order to use these services.*
150
139
 
151
140
  4. Select **Credentials** from the side navigation.
152
141
 
153
- You should see a screen like one of the following.
154
-
155
- ![Create a new service account][create-new-service-account]
156
-
157
- ![Create a new service account With Existing Keys][create-new-service-account-existing-keys]
158
-
159
- Find the "Add credentials" drop down and select "Service account" to be
160
- guided through downloading a new JSON key file.
142
+ Find the "Create credentials" drop down near the top of the page, and select
143
+ "Service account" to be guided through downloading a new JSON key file.
161
144
 
162
145
  If you want to re-use an existing service account, you can easily generate a
163
- new key file. Just select the account you wish to re-use, and click "Generate
164
- new JSON key":
165
-
166
- ![Re-use an existing service account][reuse-service-account]
146
+ new key file. Just select the account you wish to re-use, click the pencil
147
+ tool on the right side to edit the service account, select the **Keys** tab,
148
+ and then select **Add Key**.
167
149
 
168
150
  The key file you download will be used by this library to authenticate API
169
151
  requests and should be stored in a secure location.
data/README.md CHANGED
@@ -11,7 +11,7 @@ verisoned gems in as dependencies, and provides high-level methods for
11
11
  constructing clients. More information on versioned clients can be found below
12
12
  in the section titled *Which client should I use?*.
13
13
 
14
- View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-kms/latest)
14
+ View the [Client Library Documentation](https://cloud.google.com/ruby/docs/reference/google-cloud-kms/latest)
15
15
  for this library, google-cloud-kms, to see the convenience methods for
16
16
  constructing client objects. Reference documentation for the client objects
17
17
  themselves can be found in the client library documentation for the versioned
@@ -70,14 +70,14 @@ end
70
70
 
71
71
  ## Supported Ruby Versions
72
72
 
73
- This library is supported on Ruby 2.5+.
73
+ This library is supported on Ruby 2.6+.
74
74
 
75
75
  Google provides official support for Ruby versions that are actively supported
76
76
  by Ruby Core—that is, Ruby versions that are either in normal maintenance or
77
- in security maintenance, and not end of life. Currently, this means Ruby 2.5
78
- and later. Older versions of Ruby _may_ still work, but are unsupported and not
79
- recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details
80
- about the Ruby support schedule.
77
+ in security maintenance, and not end of life. Older versions of Ruby _may_
78
+ still work, but are unsupported and not recommended. See
79
+ https://www.ruby-lang.org/en/downloads/branches/ for details about the Ruby
80
+ support schedule.
81
81
 
82
82
  ## Which client should I use?
83
83
 
@@ -20,7 +20,7 @@
20
20
  module Google
21
21
  module Cloud
22
22
  module Kms
23
- VERSION = "2.2.0"
23
+ VERSION = "2.4.0"
24
24
  end
25
25
  end
26
26
  end
@@ -44,6 +44,40 @@ end
44
44
  module Google
45
45
  module Cloud
46
46
  module Kms
47
+ ##
48
+ # Create a new client object for EkmService.
49
+ #
50
+ # By default, this returns an instance of
51
+ # [Google::Cloud::Kms::V1::EkmService::Client](https://googleapis.dev/ruby/google-cloud-kms-v1/latest/Google/Cloud/Kms/V1/EkmService/Client.html)
52
+ # for version V1 of the API.
53
+ # However, you can specify specify a different API version by passing it in the
54
+ # `version` parameter. If the EkmService service is
55
+ # supported by that API version, and the corresponding gem is available, the
56
+ # appropriate versioned client will be returned.
57
+ #
58
+ # ## About EkmService
59
+ #
60
+ # Google Cloud Key Management EKM Service
61
+ #
62
+ # Manages external cryptographic keys and operations using those keys.
63
+ # Implements a REST model with the following objects:
64
+ # * EkmConnection
65
+ #
66
+ # @param version [::String, ::Symbol] The API version to connect to. Optional.
67
+ # Defaults to `:v1`.
68
+ # @return [EkmService::Client] A client object for the specified version.
69
+ #
70
+ def self.ekm_service version: :v1, &block
71
+ require "google/cloud/kms/#{version.to_s.downcase}"
72
+
73
+ package_name = Google::Cloud::Kms
74
+ .constants
75
+ .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
76
+ .first
77
+ package_module = Google::Cloud::Kms.const_get package_name
78
+ package_module.const_get(:EkmService).const_get(:Client).new(&block)
79
+ end
80
+
47
81
  ##
48
82
  # Create a new client object for KeyManagementService.
49
83
  #
@@ -98,7 +132,8 @@ module Google
98
132
  #
99
133
  # ## About IAMPolicy
100
134
  #
101
- # ## API Overview
135
+ # API Overview
136
+ #
102
137
  #
103
138
  # Manages Identity and Access Management (IAM) policies.
104
139
  #
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-kms
3
3
  version: !ruby/object:Gem::Version
4
- version: 2.2.0
4
+ version: 2.4.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2021-11-09 00:00:00.000000000 Z
11
+ date: 2022-07-02 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-cloud-core
@@ -30,7 +30,7 @@ dependencies:
30
30
  requirements:
31
31
  - - ">="
32
32
  - !ruby/object:Gem::Version
33
- version: '0.0'
33
+ version: '0.11'
34
34
  - - "<"
35
35
  - !ruby/object:Gem::Version
36
36
  version: 2.a
@@ -40,7 +40,7 @@ dependencies:
40
40
  requirements:
41
41
  - - ">="
42
42
  - !ruby/object:Gem::Version
43
- version: '0.0'
43
+ version: '0.11'
44
44
  - - "<"
45
45
  - !ruby/object:Gem::Version
46
46
  version: 2.a
@@ -50,28 +50,28 @@ dependencies:
50
50
  requirements:
51
51
  - - "~>"
52
52
  - !ruby/object:Gem::Version
53
- version: 1.25.1
53
+ version: 1.26.1
54
54
  type: :development
55
55
  prerelease: false
56
56
  version_requirements: !ruby/object:Gem::Requirement
57
57
  requirements:
58
58
  - - "~>"
59
59
  - !ruby/object:Gem::Version
60
- version: 1.25.1
60
+ version: 1.26.1
61
61
  - !ruby/object:Gem::Dependency
62
62
  name: minitest
63
63
  requirement: !ruby/object:Gem::Requirement
64
64
  requirements:
65
65
  - - "~>"
66
66
  - !ruby/object:Gem::Version
67
- version: '5.14'
67
+ version: '5.16'
68
68
  type: :development
69
69
  prerelease: false
70
70
  version_requirements: !ruby/object:Gem::Requirement
71
71
  requirements:
72
72
  - - "~>"
73
73
  - !ruby/object:Gem::Version
74
- version: '5.14'
74
+ version: '5.16'
75
75
  - !ruby/object:Gem::Dependency
76
76
  name: minitest-focus
77
77
  requirement: !ruby/object:Gem::Requirement
@@ -106,14 +106,14 @@ dependencies:
106
106
  requirements:
107
107
  - - ">="
108
108
  - !ruby/object:Gem::Version
109
- version: '12.0'
109
+ version: '13.0'
110
110
  type: :development
111
111
  prerelease: false
112
112
  version_requirements: !ruby/object:Gem::Requirement
113
113
  requirements:
114
114
  - - ">="
115
115
  - !ruby/object:Gem::Version
116
- version: '12.0'
116
+ version: '13.0'
117
117
  - !ruby/object:Gem::Dependency
118
118
  name: redcarpet
119
119
  requirement: !ruby/object:Gem::Requirement
@@ -183,14 +183,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
183
183
  requirements:
184
184
  - - ">="
185
185
  - !ruby/object:Gem::Version
186
- version: '2.5'
186
+ version: '2.6'
187
187
  required_rubygems_version: !ruby/object:Gem::Requirement
188
188
  requirements:
189
189
  - - ">="
190
190
  - !ruby/object:Gem::Version
191
191
  version: '0'
192
192
  requirements: []
193
- rubygems_version: 3.2.17
193
+ rubygems_version: 3.3.14
194
194
  signing_key:
195
195
  specification_version: 4
196
196
  summary: API Client library for the Cloud Key Management Service (KMS) API