diff options
author | 2015-10-07 13:52:47 -0700 | |
---|---|---|
committer | 2015-10-07 13:52:47 -0700 | |
commit | 4de94d41d27b0c204eac9cabdb439b142d086e1f (patch) | |
tree | 66b4a517c8b1b9b42a418c83ef0181f55f3809fc | |
parent | 47f519ece2690352132add8e7973a6f7aa7c10a3 (diff) |
Added more documentation to credentials.js
-rw-r--r-- | src/node/src/credentials.js | 25 |
1 files changed, 24 insertions, 1 deletions
diff --git a/src/node/src/credentials.js b/src/node/src/credentials.js index 97dd973715..009ff63306 100644 --- a/src/node/src/credentials.js +++ b/src/node/src/credentials.js @@ -33,6 +33,29 @@ /** * Credentials module + * + * This module contains factory methods for two different credential types: + * CallCredentials and ChannelCredentials. ChannelCredentials are things like + * SSL credentials that can be used to secure a connection, and are used to + * construct a Client object. CallCredentials genrally modify metadata, so they + * can be attached to an individual method call. + * + * CallCredentials can be composed with other CallCredentials to create + * CallCredentials. ChannelCredentials can be composed with CallCredentials + * to create ChannelCredentials. No combined credential can have more than + * one ChannelCredentials. + * + * For example, to create a client secured with SSL that uses Google + * default application credentials to authenticate: + * + * var channel_creds = credentials.createSsl(root_certs); + * (new GoogleAuth()).getApplicationDefault(function(err, credential) { + * var call_creds = credentials.createFromGoogleCredential(credential); + * var combined_creds = credentials.combineChannelCredentials( + * channel_creds, call_creds); + * var client = new Client(address, combined_creds); + * }); + * * @module */ @@ -134,7 +157,7 @@ exports.combineCallCredentials = function() { /** * Create an insecure credentials object. This is used to create a channel that - * does not use SSL. + * does not use SSL. This cannot be composed with anything. * @return {ChannelCredentials} The insecure credentials object */ exports.createInsecure = ChannelCredentials.createInsecure; |