credentials

type AssumeRoleWithOIDCResponse struct {
	ResponseMetadata response.ResponseMetadata `json:"ResponseMetadata,omitempty"`
	Result           Result                    `json:"Result,omitempty"`
}

type AssumeRoleWithSAMLResponse struct {
	ResponseMetadata response.ResponseMetadata `json:"ResponseMetadata,omitempty"`
	Result           SAMLResult                `json:"Result,omitempty"`
}

type AssumedRoleUser struct {
	AssumedRoleId string `json:"AssumedRoleId,omitempty"`
	Trn           string `json:"Trn,omitempty"`
}

type ChainProvider struct {
	Providers []Provider

	VerboseErrors bool
	// contains filtered or unexported fields
}

type Credentials struct {
	// contains filtered or unexported fields
}

type DefaultCredentialProvider struct {
	Providers []Provider
	// contains filtered or unexported fields
}

type DefaultCredentialProviderOptions struct {
	// RoleName is the ECS IMDS role name. If empty, it will be resolved
	// from env var BYTEPLUS_ECS_METADATA.
	RoleName string

	// ReuseLastProviderEnabled controls whether the chain caches and
	// reuses the last successful provider on subsequent calls.
	// Default is true.
	ReuseLastProviderEnabled *bool
}

type EcsRoleProvider struct {
	Expiry

	// RoleName is the IAM role name. If empty, resolved from env or auto-detected.
	RoleName string

	// ExpiryWindow will allow the credentials to trigger refreshing prior to
	// the credentials actually expiring.
	ExpiryWindow time.Duration

	// MaxRetries is the number of retry attempts after the initial IMDS request.
	// Nil falls back to DefaultRetryerMaxNumRetries (3); 0 disables retries.
	MaxRetries *int

	// RetryInterval is the sleep interval between IMDS retry attempts.
	// If zero or negative, it falls back to DefaultRetryerRetryDelay (1s).
	RetryInterval time.Duration
	// contains filtered or unexported fields
}

type EcsRoleProviderOptions struct {
	ExpiryWindow  time.Duration
	MaxRetries    *int
	RetryInterval time.Duration
	HttpTimeout   time.Duration
}

type EnvProvider struct {
	// contains filtered or unexported fields
}

type ErrorProvider struct {
	// The error to be returned from Retrieve
	Err error

	// The provider name to set on the Retrieved returned Value
	ProviderName string
}

type Expirer interface {
	// The time at which the credentials are no longer valid
	ExpiresAt() time.Time
}

type Expiry struct {

	// If set will be used by IsExpired to determine the current time.
	// Defaults to time.Now if CurrentTime is not set.  Available for testing
	// to be able to mock out the current time.
	CurrentTime func() time.Time
	// contains filtered or unexported fields
}

type HttpOptions struct {
	Timeout time.Duration
}

type OIDCCredentials struct {
	CurrentTime     string `json:"CurrentTime,omitempty"`
	Expiration      string `json:"Expiration,omitempty"`
	AccessKeyId     string `json:"AccessKeyId,omitempty"`
	SecretAccessKey string `json:"SecretAccessKey,omitempty"`
	SessionToken    string `json:"SessionToken,omitempty"`
}

type OIDCCredentialsProvider struct {
	OIDCTokenFilePath string
	RoleTrn           string
	RoleSessionName   string
	DurationSeconds   int
	Policy            string
	// for sts endpoint
	Schema        string
	Endpoint      string
	MaxRetries    *int          // Retry attempts. Nil falls back to DefaultRetryerMaxNumRetries (3); 0 disables retries.
	RetryInterval time.Duration // Sleep interval between retries. If zero or negative, falls back to DefaultRetryerRetryDelay (1s).

	// ProxyURL 指定访问 STS 端点时使用的正向代理地址，格式
	// scheme://[user:password@]host:port。留空时先使用绑定客户端中与 STS
	// 协议对应的 HTTPProxy/HTTPSProxy，再保留原传输层代理行为。
	ProxyURL string
	// CAFile 指定用于校验 STS 服务端证书的自定义 CA 证书文件路径（PEM 格式）。
	// 留空时保留原传输层的根证书配置，标准默认值使用系统根证书。
	CAFile string
	// InsecureSkipVerify 控制是否跳过 STS 服务端 TLS 证书校验。
	// 仅限联调（如自签证书 / 代理拦截），生产环境禁用，会导致中间人攻击风险。
	InsecureSkipVerify bool
	// contains filtered or unexported fields
}

type OIDCProviderOptions struct {
	RoleSessionName string
	DurationSeconds int
	Policy          string
	Schema          string
	Endpoint        string
	MaxRetries      *int
	RetryInterval   time.Duration
	HttpOptions     *HttpOptions
	// ProxyURL 正向代理地址，格式 scheme://[user:password@]host:port。
	ProxyURL string
	// CAFile 自定义 CA 证书文件路径（PEM 格式）。
	CAFile string
	// InsecureSkipVerify 跳过 TLS 证书校验，仅限联调，生产禁用。
	InsecureSkipVerify bool
}

type OIDCTokenInfo struct {
	Subject        string   `json:"Subject,omitempty"`
	Issuer         string   `json:"Issuer,omitempty"`
	ClientIds      []string `json:"ClientIds,omitempty"`
	ExpirationTime string   `json:"ExpirationTime,omitempty"`
	IssuanceTime   string   `json:"IssuanceTime,omitempty"`
}

type Provider interface {
	// Retrieve returns nil if it successfully retrieved the value.
	// Error is returned if the value were not obtainable, or empty.
	Retrieve() (Value, error)

	// IsExpired returns if the credentials are no longer valid, and need
	// to be retrieved.
	IsExpired() bool
}

type ProxyConfig struct {
	// ProxyURL 正向代理地址，格式 scheme://[user:password@]host:port。
	// 为空时保留原 Transport 的代理行为；标准默认 Transport 会处理
	// HTTP_PROXY / HTTPS_PROXY / NO_PROXY。
	ProxyURL string
	// CAFile 自定义 CA 证书文件路径（PEM 格式），用于校验 STS 服务端证书。
	// 为空时保留原 Transport 的 TLS 根配置；未自定义时使用系统根证书。
	CAFile string
	// InsecureSkipVerify 为 true 时跳过 TLS 证书链与主机名校验。
	// 仅限联调，生产环境禁用。
	InsecureSkipVerify bool
	// contains filtered or unexported fields
}

type Result struct {
	Credentials     OIDCCredentials `json:"Credentials,omitempty"`
	OIDCTokenInfo   OIDCTokenInfo   `json:"OIDCTokenInfo,omitempty"`
	AssumedRoleUser AssumedRoleUser `json:"AssumedRoleUser,omitempty"`
}

type SAMLCredentialsProvider struct {
	RoleTrn         string
	SAMLProviderTrn string
	SAMLAssertion   string
	DurationSeconds int
	Policy          string
	// for sts endpoint
	Schema        string
	Endpoint      string
	MaxRetries    *int          // Retry attempts. Nil falls back to DefaultRetryerMaxNumRetries (3); 0 disables retries.
	RetryInterval time.Duration // Sleep interval between retries. If zero or negative, falls back to DefaultRetryerRetryDelay (1s).

	// ProxyURL 指定访问 STS 端点时使用的正向代理地址，格式
	// scheme://[user:password@]host:port。留空时先使用绑定客户端中与 STS
	// 协议对应的 HTTPProxy/HTTPSProxy，再保留原传输层代理行为。
	ProxyURL string
	// CAFile 指定用于校验 STS 服务端证书的自定义 CA 证书文件路径（PEM 格式）。
	// 留空时保留原传输层的根证书配置，标准默认值使用系统根证书。
	CAFile string
	// InsecureSkipVerify 控制是否跳过 STS 服务端 TLS 证书校验。
	// 仅限联调（如自签证书 / 代理拦截），生产环境禁用，会导致中间人攻击风险。
	InsecureSkipVerify bool
	// contains filtered or unexported fields
}

type SAMLProviderOptions struct {
	DurationSeconds int
	Policy          string
	Schema          string
	Endpoint        string
	MaxRetries      *int
	RetryInterval   time.Duration
	HttpOptions     *HttpOptions
	// ProxyURL 正向代理地址，格式 scheme://[user:password@]host:port。
	ProxyURL string
	// CAFile 自定义 CA 证书文件路径（PEM 格式）。
	CAFile string
	// InsecureSkipVerify 跳过 TLS 证书校验，仅限联调，生产禁用。
	InsecureSkipVerify bool
}

type SAMLResult struct {
	Credentials     OIDCCredentials `json:"Credentials,omitempty"`
	AssumedRoleUser AssumedRoleUser `json:"AssumedRoleUser,omitempty"`
}

type STSConfig struct {
	Region string
	// Host is an independent AssumeRole endpoint, not a business API endpoint.
	Host       string
	HTTPProxy  string
	HTTPSProxy string
}

type SharedCredentialsProvider struct {
	// Path to the shared credentials file.
	//
	// If empty will look for "BYTEPLUS_SHARED_CREDENTIALS_FILE" env variable. If the
	// env value is empty will default to current user's home directory.
	// Linux/OSX: "$HOME/.byteplus/credentials"
	// Windows:   "%USERPROFILE%\.byteplus\credentials"
	Filename string

	// BYTEPLUS Profile to extract credentials from the shared credentials file. If empty
	// will default to environment variable "BYTEPLUS_PROFILE" or "default" if
	// environment variable is also not set.
	Profile string
	// contains filtered or unexported fields
}

type StaticProvider struct {
	Value
}

type StsAssumeRoleOptions struct {
	SessionToken    string
	Host            string
	Region          string
	Schema          string
	Timeout         time.Duration
	DurationSeconds int
	Policy          string
	// MaxRetries controls AssumeRole retry attempts.
	// Zero or negative values fall back to DefaultRetryerMaxNumRetries.
	MaxRetries    int
	RetryInterval time.Duration

	// ProxyURL 指定访问 STS 端点时使用的正向代理地址，格式
	// scheme://[user:password@]host:port。留空时先使用绑定客户端中与 STS
	// 协议对应的 HTTPProxy/HTTPSProxy，再保留原传输层代理行为。
	// 直接调用 StsAssumeRoleWithOptions 不包含客户端配置兜底层。
	ProxyURL string
	// CAFile 指定用于校验 STS 服务端证书的自定义 CA 证书文件路径（PEM 格式）。
	CAFile string
	// InsecureSkipVerify 控制是否跳过 STS 服务端 TLS 证书校验，仅限联调，生产禁用。
	InsecureSkipVerify bool
}

type StsAssumeRoleProvider struct {
	AccessKey       string
	SecurityKey     string
	SessionToken    string
	RoleName        string
	AccountId       string
	Host            string
	Region          string
	Schema          string
	Timeout         time.Duration
	DurationSeconds int
	Policy          string
	// MaxRetries controls AssumeRole retry attempts.
	// Zero or negative values fall back to DefaultRetryerMaxNumRetries.
	MaxRetries    int
	RetryInterval time.Duration

	// ProxyURL 指定访问 STS 端点时使用的正向代理地址，适用于客户端位于企业内网、
	// 需经统一出口代理访问公网的场景。
	//
	// 格式为 scheme://[user:password@]host:port，例如：
	//   - 无认证：       "http://10.0.0.1:8080"
	//   - 需账号密码：   "http://user:pass@10.0.0.1:8080"
	//
	// 代理认证信息（用户名/密码）以 Basic 方式随请求发送。若含特殊字符，
	// 请按 RFC 3986 进行百分号编码。
	//
	// 留空时先使用绑定客户端中与 STS 协议对应的 HTTPProxy/HTTPSProxy，
	// 再保留原传输层代理行为（标准默认传输层处理 HTTP_PROXY/HTTPS_PROXY/NO_PROXY）。
	// 直接调用 StsAssumeRole 不包含客户端配置兜底层。
	ProxyURL string

	// CAFile 指定用于校验 STS 服务端证书的自定义 CA 证书文件路径（PEM 格式）。
	//
	// 适用于企业代理对 HTTPS 流量做 TLS 拦截（中间人）、使用私有 CA 重新签发证书，
	// 且该 CA 未安装到操作系统信任库的场景。设置后，SDK 将以此 CA 校验证书链。
	//
	// 留空时保留原传输层的根证书配置，标准默认值使用系统根证书。
	CAFile string

	// InsecureSkipVerify 控制是否跳过 STS 服务端 TLS 证书校验。
	//
	// 置为 true 时将不校验证书链与主机名，可用于自签证书或代理拦截等联调场景。
	//
	// 警告：此选项会使连接易受中间人攻击，切勿在生产环境启用。
	// 生产环境请改用 CAFile 显式信任所需的 CA 证书。
	InsecureSkipVerify bool
}

type StsAssumeRoleTime struct {
	CurrentTime string
	ExpiredTime string
}

type StsProvider struct {
	Expiry
	StsValue
	// contains filtered or unexported fields
}

type StsValue StsAssumeRoleProvider

type Value struct {
	// byteplus Access key ID
	AccessKeyID string

	// byteplus Secret Access Key
	SecretAccessKey string

	// byteplus Session Token
	SessionToken string

	// Provider used to get credentials
	ProviderName string
}