files.com 1.1.281 → 1.1.282

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 277e804b31fa7a56ea56f43b4530e1975537c5f61e2fa7a6b5060eb6ac3c5cfc
-  data.tar.gz: b2f8b3df404cc7f5693fd7c67b4f2d663c4ce2c9263953cf07b706d190a0ea55
+  metadata.gz: d9406f38cb6bde4af6c2f9ceb7701d7ec8dec08567cbd285d6d4625ba01dafb0
+  data.tar.gz: 55ad58d9c15b6edc56a78f2cf91e2f10974701dad5348f94b5941ad98d784dcf
 SHA512:
-  metadata.gz: 58a16e0aad5987d0278448db3f8c8752b3ba83b40ccb6b3e4e912797929eca441290e0cb8304d80a0ee9af7a75c2ba503257824852095efa223fac61fad41469
-  data.tar.gz: b93231b4bae81644b269acb0748bea33a72921afb5671568ebef62a1c2897417520c19d448065a4ff8fbbdc95a481ed312649b7f8f50814cab48803c14b37233
+  metadata.gz: 88bb48032e3d7cd4473dc3e25f581392b7450546c1fd8c92938b0824c4973ed0b5043043abad5632c0c393f637ba3cc3b0a3542bdb3a894693cac9d25c0bfbd6
+  data.tar.gz: 5348e54f4683c2b78e44be056746fc47590344d3199220c9589072c87a6e082d0bd2a2398196dfc2e56240221c1dad739bb88167fcacd2fa3dc3dddfdd2dce8c

data/_VERSION

@@ -1 +1 @@
-1.1.281
+1.1.282

data/docs/gpg_key.md

@@ -21,6 +21,10 @@
 * `public_key` (string): Your GPG public key
 * `private_key` (string): Your GPG private key.
 * `private_key_password` (string): Your GPG private key password. Only required for password protected keys.
+* `generate_expires_at` (string): Expiration date of the key. Used for the generation of the key. Will be ignored if `generate_keypair` is false.
+* `generate_keypair` (boolean): If true, generate a new GPG key pair. Can not be used with `public_key`/`private_key`
+* `generate_full_name` (string): Full name of the key owner. Used for the generation of the key. Will be ignored if `generate_keypair` is false.
+* `generate_email` (string): Email address of the key owner. Used for the generation of the key. Will be ignored if `generate_keypair` is false.
 
 
 ---
@@ -64,7 +68,11 @@ Files::GpgKey.create(
   public_key: "7f8bc1210b09b9ddf469e6b6b8920e76", 
   private_key: "ab236cfe4a195f0226bc2e674afdd6b0", 
   private_key_password: "[your GPG private key password]", 
-  name: "key name"
+  name: "key name", 
+  generate_expires_at: "2025-06-19 12:00:00", 
+  generate_keypair: false, 
+  generate_full_name: "John Doe", 
+  generate_email: "jdoe@example.com"
 )
 ```
 
@@ -75,6 +83,10 @@ Files::GpgKey.create(
 * `private_key` (string): Your GPG private key.
 * `private_key_password` (string): Your GPG private key password. Only required for password protected keys.
 * `name` (string): Required - Your GPG key name.
+* `generate_expires_at` (string): Expiration date of the key. Used for the generation of the key. Will be ignored if `generate_keypair` is false.
+* `generate_keypair` (boolean): If true, generate a new GPG key pair. Can not be used with `public_key`/`private_key`
+* `generate_full_name` (string): Full name of the key owner. Used for the generation of the key. Will be ignored if `generate_keypair` is false.
+* `generate_email` (string): Email address of the key owner. Used for the generation of the key. Will be ignored if `generate_keypair` is false.
 
 
 ---

data/docs/public_key.md

@@ -9,7 +9,10 @@
   "created_at": "2000-01-01T01:00:00Z",
   "fingerprint": "43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8",
   "fingerprint_sha256": "V5Q5t/ghT3R8Tol5GX9385bzmpygWVRnLuI9EXNrjCX",
+  "status": "complete",
   "last_login_at": "2000-01-01T01:00:00Z",
+  "private_key": "example",
+  "public_key": "example",
   "username": "User",
   "user_id": 1
 }
@@ -20,10 +23,16 @@
 * `created_at` (date-time): Public key created at date/time
 * `fingerprint` (string): Public key fingerprint (MD5)
 * `fingerprint_sha256` (string): Public key fingerprint (SHA256)
+* `status` (string): Can be invalid, not_generated, generating, complete
 * `last_login_at` (date-time): Key's most recent login time via SFTP
+* `private_key` (string): Private key generated for the user.
+* `public_key` (string): Public key generated for the user.
 * `username` (string): Username of the user this public key is associated with
 * `user_id` (int64): User ID this public key is associated with
-* `public_key` (string): Actual contents of SSH key.
+* `generate_keypair` (boolean): If true, generate a new SSH key pair. Can not be used with `public_key`
+* `generate_private_key_password` (string): Password for the private key. Used for the generation of the key. Will be ignored if `generate_keypair` is false.
+* `generate_algorithm` (string): Type of key to generate.  One of rsa, dsa, ecdsa, ed25519. Used for the generation of the key. Will be ignored if `generate_keypair` is false.
+* `generate_length` (int64): Length of key to generate. If algorithm is ecdsa, this is the signature size. Used for the generation of the key. Will be ignored if `generate_keypair` is false.
 
 
 ---
@@ -69,7 +78,11 @@ Files::PublicKey.find(id)
 Files::PublicKey.create(
   user_id: 1, 
   title: "My Main Key", 
-  public_key: "public_key"
+  public_key: "example", 
+  generate_keypair: false, 
+  generate_private_key_password: "[your private key password]", 
+  generate_algorithm: "rsa", 
+  generate_length: 4096
 )
 ```
 
@@ -77,7 +90,11 @@ Files::PublicKey.create(
 
 * `user_id` (int64): User ID.  Provide a value of `0` to operate the current session's user.
 * `title` (string): Required - Internal reference for key.
-* `public_key` (string): Required - Actual contents of SSH key.
+* `public_key` (string): Actual contents of SSH key.
+* `generate_keypair` (boolean): If true, generate a new SSH key pair. Can not be used with `public_key`
+* `generate_private_key_password` (string): Password for the private key. Used for the generation of the key. Will be ignored if `generate_keypair` is false.
+* `generate_algorithm` (string): Type of key to generate.  One of rsa, dsa, ecdsa, ed25519. Used for the generation of the key. Will be ignored if `generate_keypair` is false.
+* `generate_length` (int64): Length of key to generate. If algorithm is ecdsa, this is the signature size. Used for the generation of the key. Will be ignored if `generate_keypair` is false.
 
 
 ---

data/lib/files.com/models/gpg_key.rb

@@ -72,6 +72,42 @@ module Files
       @attributes[:private_key_password] = value
     end
 
+    # string - Expiration date of the key. Used for the generation of the key. Will be ignored if `generate_keypair` is false.
+    def generate_expires_at
+      @attributes[:generate_expires_at]
+    end
+
+    def generate_expires_at=(value)
+      @attributes[:generate_expires_at] = value
+    end
+
+    # boolean - If true, generate a new GPG key pair. Can not be used with `public_key`/`private_key`
+    def generate_keypair
+      @attributes[:generate_keypair]
+    end
+
+    def generate_keypair=(value)
+      @attributes[:generate_keypair] = value
+    end
+
+    # string - Full name of the key owner. Used for the generation of the key. Will be ignored if `generate_keypair` is false.
+    def generate_full_name
+      @attributes[:generate_full_name]
+    end
+
+    def generate_full_name=(value)
+      @attributes[:generate_full_name] = value
+    end
+
+    # string - Email address of the key owner. Used for the generation of the key. Will be ignored if `generate_keypair` is false.
+    def generate_email
+      @attributes[:generate_email]
+    end
+
+    def generate_email=(value)
+      @attributes[:generate_email] = value
+    end
+
     # Parameters:
     #   public_key - string - Your GPG public key
     #   private_key - string - Your GPG private key.
@@ -159,12 +195,19 @@ module Files
     #   private_key - string - Your GPG private key.
     #   private_key_password - string - Your GPG private key password. Only required for password protected keys.
     #   name (required) - string - Your GPG key name.
+    #   generate_expires_at - string - Expiration date of the key. Used for the generation of the key. Will be ignored if `generate_keypair` is false.
+    #   generate_keypair - boolean - If true, generate a new GPG key pair. Can not be used with `public_key`/`private_key`
+    #   generate_full_name - string - Full name of the key owner. Used for the generation of the key. Will be ignored if `generate_keypair` is false.
+    #   generate_email - string - Email address of the key owner. Used for the generation of the key. Will be ignored if `generate_keypair` is false.
     def self.create(params = {}, options = {})
       raise InvalidParameterError.new("Bad parameter: user_id must be an Integer") if params[:user_id] and !params[:user_id].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: public_key must be an String") if params[:public_key] and !params[:public_key].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: private_key must be an String") if params[:private_key] and !params[:private_key].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: private_key_password must be an String") if params[:private_key_password] and !params[:private_key_password].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: name must be an String") if params[:name] and !params[:name].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: generate_expires_at must be an String") if params[:generate_expires_at] and !params[:generate_expires_at].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: generate_full_name must be an String") if params[:generate_full_name] and !params[:generate_full_name].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: generate_email must be an String") if params[:generate_email] and !params[:generate_email].is_a?(String)
       raise MissingParameterError.new("Parameter missing: name") unless params[:name]
 
       response, options = Api.send_request("/gpg_keys", :post, params, options)

data/lib/files.com/models/public_key.rb

@@ -50,6 +50,15 @@ module Files
       @attributes[:fingerprint_sha256] = value
     end
 
+    # string - Can be invalid, not_generated, generating, complete
+    def status
+      @attributes[:status]
+    end
+
+    def status=(value)
+      @attributes[:status] = value
+    end
+
     # date-time - Key's most recent login time via SFTP
     def last_login_at
       @attributes[:last_login_at]
@@ -59,6 +68,24 @@ module Files
       @attributes[:last_login_at] = value
     end
 
+    # string - Private key generated for the user.
+    def private_key
+      @attributes[:private_key]
+    end
+
+    def private_key=(value)
+      @attributes[:private_key] = value
+    end
+
+    # string - Public key generated for the user.
+    def public_key
+      @attributes[:public_key]
+    end
+
+    def public_key=(value)
+      @attributes[:public_key] = value
+    end
+
     # string - Username of the user this public key is associated with
     def username
       @attributes[:username]
@@ -77,13 +104,40 @@ module Files
       @attributes[:user_id] = value
     end
 
-    # string - Actual contents of SSH key.
-    def public_key
-      @attributes[:public_key]
+    # boolean - If true, generate a new SSH key pair. Can not be used with `public_key`
+    def generate_keypair
+      @attributes[:generate_keypair]
     end
 
-    def public_key=(value)
-      @attributes[:public_key] = value
+    def generate_keypair=(value)
+      @attributes[:generate_keypair] = value
+    end
+
+    # string - Password for the private key. Used for the generation of the key. Will be ignored if `generate_keypair` is false.
+    def generate_private_key_password
+      @attributes[:generate_private_key_password]
+    end
+
+    def generate_private_key_password=(value)
+      @attributes[:generate_private_key_password] = value
+    end
+
+    # string - Type of key to generate.  One of rsa, dsa, ecdsa, ed25519. Used for the generation of the key. Will be ignored if `generate_keypair` is false.
+    def generate_algorithm
+      @attributes[:generate_algorithm]
+    end
+
+    def generate_algorithm=(value)
+      @attributes[:generate_algorithm] = value
+    end
+
+    # int64 - Length of key to generate. If algorithm is ecdsa, this is the signature size. Used for the generation of the key. Will be ignored if `generate_keypair` is false.
+    def generate_length
+      @attributes[:generate_length]
+    end
+
+    def generate_length=(value)
+      @attributes[:generate_length] = value
     end
 
     # Parameters:
@@ -173,13 +227,19 @@ module Files
     # Parameters:
     #   user_id - int64 - User ID.  Provide a value of `0` to operate the current session's user.
     #   title (required) - string - Internal reference for key.
-    #   public_key (required) - string - Actual contents of SSH key.
+    #   public_key - string - Actual contents of SSH key.
+    #   generate_keypair - boolean - If true, generate a new SSH key pair. Can not be used with `public_key`
+    #   generate_private_key_password - string - Password for the private key. Used for the generation of the key. Will be ignored if `generate_keypair` is false.
+    #   generate_algorithm - string - Type of key to generate.  One of rsa, dsa, ecdsa, ed25519. Used for the generation of the key. Will be ignored if `generate_keypair` is false.
+    #   generate_length - int64 - Length of key to generate. If algorithm is ecdsa, this is the signature size. Used for the generation of the key. Will be ignored if `generate_keypair` is false.
     def self.create(params = {}, options = {})
       raise InvalidParameterError.new("Bad parameter: user_id must be an Integer") if params[:user_id] and !params[:user_id].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: title must be an String") if params[:title] and !params[:title].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: public_key must be an String") if params[:public_key] and !params[:public_key].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: generate_private_key_password must be an String") if params[:generate_private_key_password] and !params[:generate_private_key_password].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: generate_algorithm must be an String") if params[:generate_algorithm] and !params[:generate_algorithm].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: generate_length must be an Integer") if params[:generate_length] and !params[:generate_length].is_a?(Integer)
       raise MissingParameterError.new("Parameter missing: title") unless params[:title]
-      raise MissingParameterError.new("Parameter missing: public_key") unless params[:public_key]
 
       response, options = Api.send_request("/public_keys", :post, params, options)
       PublicKey.new(response.data, options)

data/lib/files.com/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Files
-  VERSION = "1.1.281"
+  VERSION = "1.1.282"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: files.com
 version: !ruby/object:Gem::Version
-  version: 1.1.281
+  version: 1.1.282
 platform: ruby
 authors:
 - files.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-06-18 00:00:00.000000000 Z
+date: 2025-06-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable