Logo ROOT   6.12/07
Reference Guide
TAuthenticate.h
Go to the documentation of this file.
1 // @(#)root/auth:$Id$
2 // Author: Fons Rademakers 26/11/2000
3 
4 /*************************************************************************
5  * Copyright (C) 1995-2000, Rene Brun and Fons Rademakers. *
6  * All rights reserved. *
7  * *
8  * For the licensing terms see $ROOTSYS/LICENSE. *
9  * For the list of contributors see $ROOTSYS/README/CREDITS. *
10  *************************************************************************/
11 
12 #ifndef ROOT_TAuthenticate
13 #define ROOT_TAuthenticate
14 
15 
16 //////////////////////////////////////////////////////////////////////////
17 // //
18 // TAuthenticate //
19 // //
20 // An authentication module for ROOT based network services, like rootd //
21 // and proofd. //
22 // //
23 //////////////////////////////////////////////////////////////////////////
24 
25 #include "TObject.h"
26 #include "TString.h"
27 #include "TList.h"
28 #include "TDatime.h"
29 #ifndef ROOT_rsafun
30 //#include "rsafun.h"
31 #endif
32 #include "AuthConst.h"
33 #ifdef R__SSL
34 // SSL specific headers for blowfish encryption
35 #include <openssl/blowfish.h>
36 #endif
37 
38 class TAuthenticate;
39 class THostAuth;
40 class TPluginHandler;
41 class TSocket;
42 class TRootSecContext;
43 class TVirtualMutex;
44 
45 typedef Int_t (*CheckSecCtx_t)(const char *subj, TRootSecContext *ctx);
46 typedef Int_t (*GlobusAuth_t)(TAuthenticate *auth, TString &user, TString &det);
47 typedef Int_t (*Krb5Auth_t)(TAuthenticate *auth, TString &user, TString &det, Int_t version);
48 typedef Int_t (*SecureAuth_t)(TAuthenticate *auth, const char *user, const char *passwd,
49  const char *remote, TString &det, Int_t version);
50 
52 
53 struct R__rsa_KEY; // opaque replacement for rsa_KEY
54 struct R__rsa_KEY_export; // opaque replacement for rsa_KEY_export
55 struct R__rsa_NUMBER; // opaque replacement for rsa_NUMBER
56 
57 class TAuthenticate : public TObject {
58 
59 friend class TRootAuth;
60 friend class TRootSecContext;
61 friend class TSocket;
62 
63 public:
64  enum ESecurity { kClear, kSRP, kKrb5, kGlobus, kSSH, kRfio }; // type of authentication
65 
66 private:
67  TString fDetails; // logon details (method dependent ...)
68  THostAuth *fHostAuth; // pointer to relevant authentication info
69  TString fPasswd; // user's password
70  TString fProtocol; // remote service (rootd, proofd)
71  Bool_t fPwHash; // kTRUE if fPasswd is a passwd hash
72  TString fRemote; // remote host to which we want to connect
73  Int_t fRSAKey; // Type of RSA key used
74  TRootSecContext *fSecContext; // pointer to relevant sec context
75  ESecurity fSecurity; // actual logon security level
76  TSocket *fSocket; // connection to remote daemon
77  Bool_t fSRPPwd; // kTRUE if fPasswd is a SRP passwd
78  Int_t fVersion; // 0,1,2, ... accordingly to remote daemon version
79  TString fUser; // user to be authenticated
80  Int_t fTimeOut; // timeout flag
81 
82  Int_t GenRSAKeys();
83  Bool_t GetPwHash() const { return fPwHash; }
84  Int_t GetRSAKey() const { return fRSAKey; }
85  ESecurity GetSecurity() const { return fSecurity; }
86  Bool_t GetSRPPwd() const { return fSRPPwd; }
87  const char *GetSshUser(TString user) const;
88  Int_t GetVersion() const { return fVersion; }
89  Int_t ClearAuth(TString &user, TString &passwd, Bool_t &pwhash);
90  Bool_t GetUserPasswd(TString &user, TString &passwd,
91  Bool_t &pwhash, Bool_t srppwd);
92  char *GetRandString(Int_t Opt,Int_t Len);
94  Int_t RfioAuth(TString &user);
95  void SetEnvironment();
96  Int_t SshAuth(TString &user);
97  Int_t SshError(const char *errfile);
98 
99  static TList *fgAuthInfo;
101  static Bool_t fgAuthReUse; // kTRUE is ReUse required
102  static TString fgDefaultUser; // Default user information
103  static TDatime fgExpDate; // Expiring date for new security contexts
106  static TString fgKrb5Principal; // Principal for Krb5 ticket
107  static TDatime fgLastAuthrc; // Time of last reading of fgRootAuthrc
109  static TPluginHandler *fgPasswdDialog; // Passwd dialog GUI plugin
110  static Bool_t fgPromptUser; // kTRUE if user prompt required
111  static TList *fgProofAuthInfo; // Specific lists of THostAuth fro proof
112  static Bool_t fgPwHash; // kTRUE if fgPasswd is a passwd hash
113  static Bool_t fgReadHomeAuthrc; // kTRUE to look for $HOME/.rootauthrc
114  static TString fgRootAuthrc; // Path to last rootauthrc-like file read
115  static Int_t fgRSAKey; // Default type of RSA key to be tried
116  static Int_t fgRSAInit;
117  static R__rsa_KEY fgRSAPriKey;
118  static R__rsa_KEY fgRSAPubKey;
119  static R__rsa_KEY_export* fgRSAPubExport; // array of size [2]
120 #ifdef R__SSL
121  static BF_KEY fgBFKey; // Blowfish symmetric key
122 #endif
124  static Bool_t fgSRPPwd; // kTRUE if fgPasswd is a SRP passwd
125  static TString fgUser;
126  static Bool_t fgUsrPwdCrypt; // kTRUE if encryption for UsrPwd is required
127  static Int_t fgLastError; // Last error code processed by AuthError()
128  static Int_t fgAuthTO; // if > 0, timeout in sec
129  static Int_t fgProcessID; // ID of the main thread as unique identifier
130 
131  static Bool_t CheckHost(const char *Host, const char *host);
132 
133  static void FileExpand(const char *fin, FILE *ftmp);
134  static Int_t ProofAuthSetup(TSocket *sock, Bool_t client);
135  static void RemoveSecContext(TRootSecContext *ctx);
136 
137 public:
138  TAuthenticate(TSocket *sock, const char *remote, const char *proto,
139  const char *user = "");
140  virtual ~TAuthenticate() { }
141 
143  Int_t AuthExists(TString User, Int_t method, const char *Options,
144  Int_t *Message, Int_t *Rflag, CheckSecCtx_t funcheck);
145  void CatchTimeOut();
146  Bool_t CheckNetrc(TString &user, TString &passwd);
147  Bool_t CheckNetrc(TString &user, TString &passwd,
148  Bool_t &pwhash, Bool_t srppwd);
149  THostAuth *GetHostAuth() const { return fHostAuth; }
150  const char *GetProtocol() const { return fProtocol; }
151  const char *GetRemoteHost() const { return fRemote; }
152  Int_t GetRSAKeyType() const { return fRSAKey; }
154  TSocket *GetSocket() const { return fSocket; }
155  const char *GetUser() const { return fUser; }
156  Int_t HasTimedOut() const { return fTimeOut; }
157  void SetRSAKeyType(Int_t key) { fRSAKey = key; }
158  void SetSecContext(TRootSecContext *ctx) { fSecContext = ctx; }
159 
160  static void AuthError(const char *where, Int_t error);
161  static Bool_t CheckProofAuth(Int_t cSec, TString &det);
162 
163  static Int_t DecodeRSAPublic(const char *rsapubexport, R__rsa_NUMBER &n,
164  R__rsa_NUMBER &d, char **rsassl = 0);
165 
166  static TList *GetAuthInfo();
167  static const char *GetAuthMethod(Int_t idx);
168  static Int_t GetAuthMethodIdx(const char *meth);
169  static Bool_t GetAuthReUse();
170  static Int_t GetClientProtocol();
171  static char *GetDefaultDetails(Int_t method, Int_t opt, const char *user);
172  static const char *GetDefaultUser();
173  static TDatime GetGlobalExpDate();
174  static Bool_t GetGlobalPwHash();
175  static Bool_t GetGlobalSRPPwd();
176  static const char *GetGlobalUser();
178  static THostAuth *GetHostAuth(const char *host, const char *user="",
179  Option_t *opt = "R", Int_t *Exact = 0);
180  static const char *GetKrb5Principal();
181  static Bool_t GetPromptUser();
182  static TList *GetProofAuthInfo();
183  static Int_t GetRSAInit();
184  static const char *GetRSAPubExport(Int_t key = 0);
185  static THostAuth *HasHostAuth(const char *host, const char *user,
186  Option_t *opt = "R");
187  static void InitRandom();
188  static void MergeHostAuthList(TList *Std, TList *New, Option_t *Opt = "");
189  static char *PromptPasswd(const char *prompt = "Password: ");
190  static char *PromptUser(const char *remote);
191  static Int_t ReadRootAuthrc();
192  static void RemoveHostAuth(THostAuth *ha, Option_t *opt = "");
193  static Int_t SecureRecv(TSocket *Socket, Int_t dec,
194  Int_t KeyType, char **Out);
195  static Int_t SecureSend(TSocket *Socket, Int_t enc,
196  Int_t KeyType, const char *In);
197  static Int_t SendRSAPublicKey(TSocket *Socket, Int_t key = 0);
198  static void SetAuthReUse(Bool_t authreuse);
199  static void SetDefaultUser(const char *defaultuser);
200  static void SetGlobalExpDate(TDatime expdate);
201  static void SetGlobalPasswd(const char *passwd);
202  static void SetGlobalPwHash(Bool_t pwhash);
203  static void SetGlobalSRPPwd(Bool_t srppwd);
204  static void SetGlobalUser(const char *user);
205  static void SetGlobusAuthHook(GlobusAuth_t func);
206  static void SetKrb5AuthHook(Krb5Auth_t func);
207  static void SetPromptUser(Bool_t promptuser);
208  static void SetDefaultRSAKeyType(Int_t key);
209  static void SetReadHomeAuthrc(Bool_t readhomeauthrc); // for PROOF
210  static void SetRSAInit(Int_t init = 1);
211  static Int_t SetRSAPublic(const char *rsapubexport, Int_t klen);
212  static void SetSecureAuthHook(SecureAuth_t func);
213  static void SetTimeOut(Int_t to);
214  static void Show(Option_t *opt="S");
215 
216  ClassDef(TAuthenticate,0) // Class providing remote authentication service
217 };
218 
219 #endif
THostAuth * GetHostAuth() const
static Bool_t GetGlobalSRPPwd()
Static method returning the global SRP password flag.
static void SetKrb5AuthHook(Krb5Auth_t func)
Set kerberos5 authorization function.
static void SetDefaultUser(const char *defaultuser)
Set default user name.
static Int_t GetRSAInit()
Static method returning the RSA initialization flag.
static Int_t GetClientProtocol()
Static method returning supported client protocol.
void SetRSAKeyType(Int_t key)
static void InitRandom()
Initialize random machine using seed from /dev/urandom (or current time if /dev/urandom not available...
static Bool_t GetAuthReUse()
Static method returning the authentication reuse settings.
static Int_t fgAuthTO
THostAuth * fHostAuth
Definition: TAuthenticate.h:68
TString fPasswd
Definition: TAuthenticate.h:69
static Bool_t fgUsrPwdCrypt
static TDatime fgExpDate
static void RemoveSecContext(TRootSecContext *ctx)
Tool for removing SecContext ctx from THostAuth listed in fgAuthInfo or fgProofAuthInfo.
TSocket * GetSocket() const
Int_t AuthExists(TString User, Int_t method, const char *Options, Int_t *Message, Int_t *Rflag, CheckSecCtx_t funcheck)
Check if we have a valid established sec context in memory Retrieves relevant info and negotiates wit...
Bool_t GetPwHash() const
Definition: TAuthenticate.h:83
static Bool_t fgPromptUser
Int_t(* GlobusAuth_t)(TAuthenticate *auth, TString &user, TString &det)
Definition: TAuthenticate.h:46
const char Option_t
Definition: RtypesCore.h:62
TString fDetails
Definition: TAuthenticate.h:67
static void SetGlobalUser(const char *user)
Set global user name to be used for authentication to rootd or proofd.
Int_t(* Krb5Auth_t)(TAuthenticate *auth, TString &user, TString &det, Int_t version)
Definition: TAuthenticate.h:47
Int_t SshAuth(TString &user)
SSH client authentication code.
static void RemoveHostAuth(THostAuth *ha, Option_t *opt="")
Remove THostAuth instance from the list.
const char * GetSshUser(TString user) const
Method returning the user to be used for the ssh login.
This class implements a mutex interface.
Definition: TVirtualMutex.h:34
static GlobusAuth_t GetGlobusAuthHook()
Static method returning the globus authorization hook.
Basic string class.
Definition: TString.h:125
static Bool_t fgSRPPwd
const Int_t kMAXSEC
Definition: AuthConst.h:26
Int_t GetRSAKeyType() const
int Int_t
Definition: RtypesCore.h:41
bool Bool_t
Definition: RtypesCore.h:59
const char * GetProtocol() const
static TList * fgProofAuthInfo
static char * GetDefaultDetails(Int_t method, Int_t opt, const char *user)
Determine default authentication details for method &#39;sec&#39; and user &#39;usr&#39;.
const char * GetRemoteHost() const
static const char * GetKrb5Principal()
Static method returning the principal to be used to init Krb5 tickets.
R__EXTERN TVirtualMutex * gAuthenticateMutex
Definition: TAuthenticate.h:51
Bool_t Authenticate()
Authenticate to remote rootd or proofd server.
static SecureAuth_t fgSecAuthHook
static void SetReadHomeAuthrc(Bool_t readhomeauthrc)
Set flag controlling the reading of $HOME/.rootauthrc.
Int_t ClearAuth(TString &user, TString &passwd, Bool_t &pwhash)
UsrPwd client authentication code.
static TPluginHandler * fgPasswdDialog
static Int_t fgRSAKey
static Int_t ReadRootAuthrc()
Read authentication directives from $ROOTAUTHRC, $HOME/.rootauthrc or <Root_etc_dir>/system.rootauthrc and create related THostAuth objects.
static TList * fgAuthInfo
Definition: TAuthenticate.h:99
static void SetPromptUser(Bool_t promptuser)
Set global PromptUser flag.
static char * PromptPasswd(const char *prompt="Password: ")
Static method to prompt for the user&#39;s passwd to be used for authentication to rootd or proofd...
static GlobusAuth_t fgGlobusAuthHook
static Int_t fgProcessID
#define ClassDef(name, id)
Definition: Rtypes.h:320
ESecurity fSecurity
Definition: TAuthenticate.h:75
Int_t HasTimedOut() const
Int_t ProofAuthSetup()
Authentication related stuff setup in TProofServ.
Int_t RfioAuth(TString &user)
UidGid client authentication code.
static Int_t fgRSAInit
static void SetTimeOut(Int_t to)
Set timeout (active if > 0)
static void SetGlobalSRPPwd(Bool_t srppwd)
Set global SRP passwd flag to be used for authentication to rootd or proofd.
static Bool_t GetPromptUser()
Static method returning the prompt user settings.
TRootSecContext * GetSecContext() const
TAuthenticate(TSocket *sock, const char *remote, const char *proto, const char *user="")
Create authentication object.
Int_t(* CheckSecCtx_t)(const char *subj, TRootSecContext *ctx)
Definition: TAuthenticate.h:45
static Int_t SecureSend(TSocket *Socket, Int_t enc, Int_t KeyType, const char *In)
Encode null terminated str using the session private key indicated by enc and sends it over the netwo...
A doubly linked list.
Definition: TList.h:44
static R__rsa_KEY_export * fgRSAPubExport
void SetSecContext(TRootSecContext *ctx)
Int_t SshError(const char *errfile)
SSH error parsing: returns 0 : no error or fatal 1 : should retry (eg &#39;connection closed by remote ho...
static void AuthError(const char *where, Int_t error)
Print error string depending on error code.
static Krb5Auth_t fgKrb5AuthHook
static void SetRSAInit(Int_t init=1)
Static method setting RSA initialization flag.
static R__rsa_KEY fgRSAPubKey
static TDatime GetGlobalExpDate()
Static method returning default expiring date for new validity contexts.
Int_t(* SecureAuth_t)(TAuthenticate *auth, const char *user, const char *passwd, const char *remote, TString &det, Int_t version)
Definition: TAuthenticate.h:48
static void SetSecureAuthHook(SecureAuth_t func)
Set secure authorization function.
static R__rsa_KEY fgRSAPriKey
Int_t GenRSAKeys()
Generate a valid pair of private/public RSA keys to protect for authentication token exchange...
Int_t GetRSAKey() const
Definition: TAuthenticate.h:84
static char * PromptUser(const char *remote)
Static method to prompt for the user name to be used for authentication to rootd or proofd...
static TList * GetProofAuthInfo()
Static method returning the list with authentication directives to be sent to proof.
static Int_t SetRSAPublic(const char *rsapubexport, Int_t klen)
Store RSA public keys from export string rsaPubExport.
static Bool_t CheckProofAuth(Int_t cSec, TString &det)
Check if the authentication method can be attempted for the client.
Int_t GetVersion() const
Definition: TAuthenticate.h:88
TRootSecContext * fSecContext
Definition: TAuthenticate.h:74
static const char * GetDefaultUser()
Static method returning the default user information.
static TDatime fgLastAuthrc
static void Show(Option_t *opt="S")
Print info about the authentication sector.
static TString fgUser
ESecurity GetSecurity() const
Definition: TAuthenticate.h:85
static TList * GetAuthInfo()
Static method returning the list with authentication details.
static void SetAuthReUse(Bool_t authreuse)
Set global AuthReUse flag.
TString fProtocol
Definition: TAuthenticate.h:70
static Int_t fgLastError
static TString fgKrb5Principal
static Int_t init()
void CatchTimeOut()
Called in connection with a timer timeout.
TSocket * fSocket
Definition: TAuthenticate.h:76
Bool_t GetUserPasswd(TString &user, TString &passwd, Bool_t &pwhash, Bool_t srppwd)
Try to get user name and passwd from several sources.
void SetEnvironment()
Set default authentication environment.
static void FileExpand(const char *fin, FILE *ftmp)
Expands include directives found in fexp files The expanded, temporary file, is pointed to by &#39;ftmp&#39; ...
static Int_t SecureRecv(TSocket *Socket, Int_t dec, Int_t KeyType, char **Out)
Receive str from sock and decode it using key indicated by key type Return number of received bytes o...
static Bool_t CheckHost(const char *Host, const char *host)
Check if &#39;host&#39; matches &#39;href&#39;: this means either equal or "containing" it, even with wild cards * in...
static void SetGlobalExpDate(TDatime expdate)
Set default expiring date for new validity contexts.
static TString fgDefaultUser
static void SetGlobusAuthHook(GlobusAuth_t func)
Set Globus authorization function.
static void SetGlobalPwHash(Bool_t pwhash)
Set global passwd hash flag to be used for authentication to rootd or proofd.
static void MergeHostAuthList(TList *Std, TList *New, Option_t *Opt="")
Tool for updating fgAuthInfo or fgProofAuthInfo &#39;nin&#39; contains list of last input information through...
Bool_t GetSRPPwd() const
Definition: TAuthenticate.h:86
static TString fgPasswd
static const char * GetRSAPubExport(Int_t key=0)
Static method returning the RSA public keys.
Mother of all ROOT objects.
Definition: TObject.h:37
static TString fgRootAuthrc
virtual ~TAuthenticate()
#define R__EXTERN
Definition: DllImport.h:27
static const char * GetGlobalUser()
Static method returning the global user.
static Bool_t fgPwHash
static TString fgAuthMeth[kMAXSEC]
const char * proto
Definition: civetweb.c:11652
static Bool_t fgReadHomeAuthrc
Bool_t CheckNetrc(TString &user, TString &passwd)
Try to get user name and passwd from the ~/.rootnetrc or ~/.netrc files.
char * GetRandString(Int_t Opt, Int_t Len)
Allocates and fills a 0 terminated buffer of length len+1 with len random characters.
static void SetDefaultRSAKeyType(Int_t key)
Static method setting the default type of RSA key.
static Bool_t GetGlobalPwHash()
Static method returning the global password hash flag.
const char * GetUser() const
static Bool_t fgAuthReUse
TString fRemote
Definition: TAuthenticate.h:72
static Int_t GetAuthMethodIdx(const char *meth)
Static method returning the method index (which can be used to find the method in GetAuthMethod())...
const Int_t n
Definition: legend1.C:16
static THostAuth * HasHostAuth(const char *host, const char *user, Option_t *opt="R")
Checks if a THostAuth with exact match for {host,user} exists in the fgAuthInfo list If opt = "P" use...
static void SetGlobalPasswd(const char *passwd)
Set global passwd to be used for authentication to rootd or proofd.
static Int_t DecodeRSAPublic(const char *rsapubexport, R__rsa_NUMBER &n, R__rsa_NUMBER &d, char **rsassl=0)
Store RSA public keys from export string rsaPubExport.
static Int_t SendRSAPublicKey(TSocket *Socket, Int_t key=0)
Receives server RSA Public key Sends local RSA public key encoded.
This class stores the date and time with a precision of one second in an unsigned 32 bit word (950130...
Definition: TDatime.h:37
static const char * GetAuthMethod(Int_t idx)
Static method returning the method corresponding to idx.