peridot/vendor/cloud.google.com/go/auth/internal/transport/cert/default_cert.go

// Copyright 2023 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//      http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

package cert

import (
	"crypto/tls"
	"errors"
	"sync"
)

// defaultCertData holds all the variables pertaining to
// the default certificate provider created by [DefaultProvider].
//
// A singleton model is used to allow the provider to be reused
// by the transport layer. As mentioned in [DefaultProvider] (provider nil, nil)
// may be returned to indicate a default provider could not be found, which
// will skip extra tls config in the transport layer .
type defaultCertData struct {
	once     sync.Once
	provider Provider
	err      error
}

var (
	defaultCert defaultCertData
)

// Provider is a function that can be passed into crypto/tls.Config.GetClientCertificate.
type Provider func(*tls.CertificateRequestInfo) (*tls.Certificate, error)

// errSourceUnavailable is a sentinel error to indicate certificate source is unavailable.
var errSourceUnavailable = errors.New("certificate source is unavailable")

// DefaultProvider returns a certificate source using the preferred EnterpriseCertificateProxySource.
// If EnterpriseCertificateProxySource is not available, fall back to the legacy SecureConnectSource.
//
// If neither source is available (due to missing configurations), a nil Source and a nil Error are
// returned to indicate that a default certificate source is unavailable.
func DefaultProvider() (Provider, error) {
	defaultCert.once.Do(func() {
		defaultCert.provider, defaultCert.err = NewWorkloadX509CertProvider("")
		if errors.Is(defaultCert.err, errSourceUnavailable) {
			defaultCert.provider, defaultCert.err = NewEnterpriseCertificateProxyProvider("")
			if errors.Is(defaultCert.err, errSourceUnavailable) {
				defaultCert.provider, defaultCert.err = NewSecureConnectProvider("")
				if errors.Is(defaultCert.err, errSourceUnavailable) {
					defaultCert.provider, defaultCert.err = nil, nil
				}
			}
		}
	})
	return defaultCert.provider, defaultCert.err
}