google-cloud-logging 2.5.0 → 2.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 657dd5524961ef04e416dc5bfe1186ba9217ad829bafdea4520177f94e8be951
-  data.tar.gz: c030a7b24ce70cc161b8368656700f0e26145cee9552830fd9b28ab28ae72b93
+  metadata.gz: 2816c11f44d21e93dd932e1b404d09672e941c2a41b504d564bd9706b7cda23b
+  data.tar.gz: d2a9a2c155f111f69eebe90ccefbe0f16bbebfe83baef825df2c4030fd39dbc0
 SHA512:
-  metadata.gz: c1c039ba7dac2ec400385c2b8ea494fe4397db3249c553da4030b91257719fb3b2f568cdb7c0df683f66b1240a1a69c4aa2c586760f40396fd4782d2782432b8
-  data.tar.gz: 8c12bbd2eacb0780d62af3dc27d70f1ef8de514c352ff45511f0f974324edd61442ced8eeab874fdab7491bcc80965add4a3dcb5a7e588bb30cf9623371fecde
+  metadata.gz: 25c01fe153ae282da7abd367f7292a95e93847ca1c2f6219f57632d83a85e5baac2c5722077e40a1094771ff26022eef640fa9f4d2d053e72aa9bb320a0b3db5
+  data.tar.gz: f52e922267736277b2ec5c2c213addcec76e247a0286c31144b83dbbfe6b200bdb75abb501e73d309b7a5a0d03622502f485897e214ee2c96d0ca7da430f9d11

data/AUTHENTICATION.md

@@ -46,6 +46,12 @@ code.
 
 **Credentials** are discovered in the following order:
 
+> [!WARNING]
+> If you accept a credential configuration (JSON file or Hash) from an
+> external source for authentication to Google Cloud, you must validate it before
+> providing it to a Google API client library. Providing an unvalidated credential
+> configuration to Google APIs can compromise the security of your systems and data.
+
 1. Specify credentials in method arguments
 2. Specify credentials in configuration
 3. Discover credentials path in environment variables
@@ -100,11 +106,16 @@ The **Project ID** and the path to the **Credentials JSON** file can be configur
 instead of placing them in environment variables or providing them as arguments.
 
 ```ruby
+require "googleauth"
 require "google/cloud/logging"
 
+credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
+  json_key_io: ::File.open("/path/to/keyfile.json")
+)
+
 Google::Cloud::Logging.configure do |config|
   config.project_id  = "my-project-id"
-  config.credentials = "path/to/keyfile.json"
+  config.credentials = credentials
 end
 
 client = Google::Cloud::Logging.new

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Release History
 
+### 2.6.1 (2025-11-04)
+
+#### Documentation
+
+* add warning about loading unvalidated credentials ([#32121](https://github.com/googleapis/google-cloud-ruby/issues/32121)) 
+
+### 2.6.0 (2025-03-04)
+
+#### Features
+
+* Update minimum Ruby version to 3.0 ([#29261](https://github.com/googleapis/google-cloud-ruby/issues/29261)) 
+
 ### 2.5.0 (2024-07-09)
 
 #### Features

data/lib/google/cloud/logging/project.rb

@@ -360,7 +360,6 @@ module Google
         def async_writer max_batch_count: 10_000, max_batch_bytes: 10_000_000,
                          max_queue_size: 100, interval: 5, threads: 10,
                          partial_success: false
-
           AsyncWriter.new self, max_count: max_batch_count,
                                 max_bytes: max_batch_bytes,
                                 max_queue: max_queue_size,

data/lib/google/cloud/logging/service.rb

@@ -83,7 +83,6 @@ module Google
 
         def list_entries resources: nil, filter: nil, order: nil, token: nil,
                          max: nil, projects: nil
-
           project_ids = Array(projects).map { |p| "projects/#{p}" }
           resource_names = Array(resources) + project_ids
           resource_names = ["projects/#{@project}"] if resource_names.empty?

data/lib/google/cloud/logging/version.rb

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Logging
-      VERSION = "2.5.0".freeze
+      VERSION = "2.6.1".freeze
     end
   end
 end

data/lib/google/cloud/logging.rb

@@ -50,9 +50,27 @@ module Google
       # @param [String] project_id Project identifier for the Stackdriver
       #   Logging service you are connecting to. If not present, the default
       #   project for the credentials is used.
-      # @param [String, Hash, Google::Auth::Credentials] credentials The path to
-      #   the keyfile as a String, the contents of the keyfile as a Hash, or a
-      #   Google::Auth::Credentials object. (See {Logging::Credentials})
+      # @param [Google::Auth::Credentials] credentials A Google::Auth::Credentials
+      #   object. (See {Logging::Credentials})
+      #   @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
+      #     is deprecated. Providing an unvalidated credential configuration to
+      #     Google APIs can compromise the security of your systems and data.
+      #
+      #   @example
+      #
+      #     # The recommended way to provide credentials is to use the `make_creds` method
+      #     # on the appropriate credentials class for your environment.
+      #
+      #     require "googleauth"
+      #
+      #     credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
+      #       json_key_io: ::File.open("/path/to/keyfile.json")
+      #     )
+      #
+      #     logging = Google::Cloud::Logging.new(
+      #       project_id: "my-project-id",
+      #       credentials: credentials
+      #     )
       # @param [String, Array<String>] scope The OAuth 2.0 scopes controlling
       #   the set of resources and operations that the connection can access.
       #   See [Using OAuth 2.0 to Access Google

data/lib/google-cloud-logging.rb

@@ -80,9 +80,25 @@ module Google
     # @param [String] project_id Project identifier for the Stackdriver Logging
     #   service you are connecting to. If not present, the default project for
     #   the credentials is used.
-    # @param [String, Hash, Google::Auth::Credentials] credentials The path to
-    #   the keyfile as a String, the contents of the keyfile as a Hash, or a
-    #   Google::Auth::Credentials object. (See {Logging::Credentials})
+    # @param [Google::Auth::Credentials] credentials A Google::Auth::Credentials
+    #   object. (See {Logging::Credentials})
+    #   @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
+    #     is deprecated. Providing an unvalidated credential configuration to
+    #     Google APIs can compromise the security of your systems and data.
+    #
+    #   @example
+    #
+    #     # The recommended way to provide credentials is to use the `make_creds` method
+    #     # on the appropriate credentials class for your environment.
+    #
+    #     credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
+    #       json_key_io: ::File.open("/path/to/keyfile.json")
+    #     )
+    #
+    #     logging = Google::Cloud::Logging.new(
+    #       project_id: "my-project-id",
+    #       credentials: credentials
+    #     )
     # @param [String, Array<String>] scope The OAuth 2.0 scopes controlling the
     #   set of resources and operations that the connection can access. See
     #   [Using OAuth 2.0 to Access Google

metadata

@@ -1,15 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-logging
 version: !ruby/object:Gem::Version
-  version: 2.5.0
+  version: 2.6.1
 platform: ruby
 authors:
 - Mike Moore
 - Chris Smith
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-07-09 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-core
@@ -120,7 +119,6 @@ homepage: https://github.com/googleapis/google-cloud-ruby/tree/master/google-clo
 licenses:
 - Apache-2.0
 metadata: {}
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -128,15 +126,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.7'
+      version: '3.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.6
-signing_key: 
+rubygems_version: 3.6.9
 specification_version: 4
 summary: API Client library for Stackdriver Logging
 test_files: []