fix: fix the document of secure_authorized_session (#1536) · googleapis/google-auth-library-python@5d00147

@@ -146,7 +146,7 @@ def secure_authorized_channel(

146146

regular_ssl_credentials = grpc.ssl_channel_credentials()

147147148148

channel = google.auth.transport.grpc.secure_authorized_channel(

149-

credentials, regular_endpoint, request,

149+

credentials, request, regular_endpoint,

150150

ssl_credentials=regular_ssl_credentials)

151151152152

Option 2: create a mutual TLS channel by calling a callback which returns

@@ -162,7 +162,7 @@ def my_client_cert_callback():

162162163163

try:

164164

channel = google.auth.transport.grpc.secure_authorized_channel(

165-

credentials, mtls_endpoint, request,

165+

credentials, request, mtls_endpoint,

166166

client_cert_callback=my_client_cert_callback)

167167

except MyClientCertFailureException:

168168

# handle the exception

@@ -186,7 +186,7 @@ def my_client_cert_callback():

186186

else:

187187

endpoint_to_use = regular_endpoint

188188

channel = google.auth.transport.grpc.secure_authorized_channel(

189-

credentials, endpoint_to_use, request,

189+

credentials, request, endpoint_to_use,

190190

ssl_credentials=default_ssl_credentials)

191191192192

Option 4: not setting ssl_credentials and client_cert_callback. For devices

@@ -200,14 +200,14 @@ def my_client_cert_callback():

200200

certificate and key::

201201202202

channel = google.auth.transport.grpc.secure_authorized_channel(

203-

credentials, regular_endpoint, request)

203+

credentials, request, regular_endpoint)

204204205205

The following code uses mtls_endpoint, if the created channle is regular,

206206

and API mtls_endpoint is confgured to require client SSL credentials, API

207207

calls using this channel will be rejected::

208208209209

channel = google.auth.transport.grpc.secure_authorized_channel(

210-

credentials, mtls_endpoint, request)

210+

credentials, request, mtls_endpoint)

211211212212

Args:

213213

credentials (google.auth.credentials.Credentials): The credentials to