Class: Stripe::Apps::Secret

Inherits:
Stripe::APIResource show all
Extended by:
Stripe::APIOperations::Create, Stripe::APIOperations::List
Defined in:
lib/stripe/resources/apps/secret.rb

Overview

Secret Store is an API that allows Stripe Apps developers to securely persist secrets for use by UI Extensions and app backends.

The primary resource in Secret Store is a ‘secret`. Other apps can’t view secrets created by an app. Additionally, secrets are scoped to provide further permission control.

All Dashboard users and the app backend share ‘account` scoped secrets. Use the `account` scope for secrets that don’t change per-user, like a third-party API key.

A ‘user` scoped secret is accessible by the app backend and one specific Dashboard user. Use the `user` scope for per-user secrets like per-user OAuth tokens, where different users might have different permissions.

Related guide: [Store data between page reloads](stripe.com/docs/stripe-apps/store-auth-data-custom-objects)

Defined Under Namespace

Classes: CreateParams, DeleteWhereParams, FindParams, ListParams, Scope

Constant Summary collapse

OBJECT_NAME = 
"apps.secret"

Constants inherited from StripeObject

StripeObject::RESERVED_FIELD_NAMES

Instance Attribute Summary collapse

Attributes inherited from Stripe::APIResource

#save_with_parent

Attributes inherited from StripeObject

#last_response

Class Method Summary collapse

Methods included from Stripe::APIOperations::Create

create

Methods included from Stripe::APIOperations::List

list

Methods inherited from Stripe::APIResource

class_name, custom_method, #refresh, #request_stripe_object, resource_url, #resource_url, retrieve, save_nested_resource

Methods included from Stripe::APIOperations::Request

included

Methods inherited from StripeObject

#==, #[], #[]=, #_get_inner_class_type, additive_object_param, additive_object_param?, #as_json, construct_from, #deleted?, #dirty!, #each, #eql?, #hash, #initialize, #inspect, #keys, #marshal_dump, #marshal_load, protected_fields, #serialize_params, #to_hash, #to_json, #to_s, #update_attributes, #values

Constructor Details

This class inherits a constructor from Stripe::StripeObject

Dynamic Method Handling

This class handles dynamic methods through the method_missing method in the class Stripe::StripeObject

Instance Attribute Details

#created ⇒ Object (readonly)

Time at which the object was created. Measured in seconds since the Unix epoch.



155
156
157
 
# File 'lib/stripe/resources/apps/secret.rb', line 155

def created
  @created
end

#deleted ⇒ Object (readonly)

If true, indicates that this secret has been deleted



157
158
159
 
# File 'lib/stripe/resources/apps/secret.rb', line 157

def deleted
  @deleted
end

#expires_at ⇒ Object (readonly)

The Unix timestamp for the expiry time of the secret, after which the secret deletes.



159
160
161
 
# File 'lib/stripe/resources/apps/secret.rb', line 159

def expires_at
  @expires_at
end

#id ⇒ Object (readonly)

Unique identifier for the object.



161
162
163
 
# File 'lib/stripe/resources/apps/secret.rb', line 161

def id
  @id
end

#livemode ⇒ Object (readonly)

Has the value ‘true` if the object exists in live mode or the value `false` if the object exists in test mode.



163
164
165
 
# File 'lib/stripe/resources/apps/secret.rb', line 163

def livemode
  @livemode
end

#name ⇒ Object (readonly)

A name for the secret that’s unique within the scope.



165
166
167
 
# File 'lib/stripe/resources/apps/secret.rb', line 165

def name
  @name
end

#object ⇒ Object (readonly)

String representing the object’s type. Objects of the same type share the same value.



167
168
169
 
# File 'lib/stripe/resources/apps/secret.rb', line 167

def object
  @object
end

#payload ⇒ Object (readonly)

The plaintext secret value to be stored.



169
170
171
 
# File 'lib/stripe/resources/apps/secret.rb', line 169

def payload
  @payload
end

#scope ⇒ Object (readonly)

Attribute for field scope



171
172
173
 
# File 'lib/stripe/resources/apps/secret.rb', line 171

def scope
  @scope
end

Class Method Details

.create(params = {}, opts = {}) ⇒ Object

Create or replace a secret in the secret store.



174
175
176
 
# File 'lib/stripe/resources/apps/secret.rb', line 174

def self.create(params = {}, opts = {})
  request_stripe_object(method: :post, path: "/v1/apps/secrets", params: params, opts: opts)
end

.delete_where(params = {}, opts = {}) ⇒ Object

Deletes a secret from the secret store by name and scope.



179
180
181
182
183
184
185
186
 
# File 'lib/stripe/resources/apps/secret.rb', line 179

def self.delete_where(params = {}, opts = {})
  request_stripe_object(
    method: :post,
    path: "/v1/apps/secrets/delete",
    params: params,
    opts: opts
  )
end

.field_remappings ⇒ Object 



207
208
209
 
# File 'lib/stripe/resources/apps/secret.rb', line 207

def self.field_remappings
  @field_remappings = {}
end

.find(params = {}, opts = {}) ⇒ Object

Finds a secret in the secret store by name and scope.



189
190
191
192
193
194
195
196
 
# File 'lib/stripe/resources/apps/secret.rb', line 189

def self.find(params = {}, opts = {})
  request_stripe_object(
    method: :get,
    path: "/v1/apps/secrets/find",
    params: params,
    opts: opts
  )
end

.inner_class_types ⇒ Object 



203
204
205
 
# File 'lib/stripe/resources/apps/secret.rb', line 203

def self.inner_class_types
  @inner_class_types = { scope: Scope }
end

.list(params = {}, opts = {}) ⇒ Object

List all secrets stored on the given scope.



199
200
201
 
# File 'lib/stripe/resources/apps/secret.rb', line 199

def self.list(params = {}, opts = {})
  request_stripe_object(method: :get, path: "/v1/apps/secrets", params: params, opts: opts)
end

.object_name ⇒ Object 



20
21
22
 
# File 'lib/stripe/resources/apps/secret.rb', line 20

def self.object_name
  "apps.secret"
end