Logo ROOT   6.14/05
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 
34 class TAuthenticate;
35 class THostAuth;
36 class TPluginHandler;
37 class TSocket;
38 class TRootSecContext;
39 class TVirtualMutex;
40 
41 typedef Int_t (*CheckSecCtx_t)(const char *subj, TRootSecContext *ctx);
42 typedef Int_t (*GlobusAuth_t)(TAuthenticate *auth, TString &user, TString &det);
43 typedef Int_t (*Krb5Auth_t)(TAuthenticate *auth, TString &user, TString &det, Int_t version);
44 typedef Int_t (*SecureAuth_t)(TAuthenticate *auth, const char *user, const char *passwd,
45  const char *remote, TString &det, Int_t version);
46 
48 
49 struct R__rsa_KEY; // opaque replacement for rsa_KEY
50 struct R__rsa_KEY_export; // opaque replacement for rsa_KEY_export
51 struct R__rsa_NUMBER; // opaque replacement for rsa_NUMBER
52 
53 class TAuthenticate : public TObject {
54 
55 friend class TRootAuth;
56 friend class TRootSecContext;
57 friend class TSocket;
58 
59 public:
60  enum ESecurity { kClear, kSRP, kKrb5, kGlobus, kSSH, kRfio }; // type of authentication
61 
62 private:
63  TString fDetails; // logon details (method dependent ...)
64  THostAuth *fHostAuth; // pointer to relevant authentication info
65  TString fPasswd; // user's password
66  TString fProtocol; // remote service (rootd, proofd)
67  Bool_t fPwHash; // kTRUE if fPasswd is a passwd hash
68  TString fRemote; // remote host to which we want to connect
69  Int_t fRSAKey; // Type of RSA key used
70  TRootSecContext *fSecContext; // pointer to relevant sec context
71  ESecurity fSecurity; // actual logon security level
72  TSocket *fSocket; // connection to remote daemon
73  Bool_t fSRPPwd; // kTRUE if fPasswd is a SRP passwd
74  Int_t fVersion; // 0,1,2, ... accordingly to remote daemon version
75  TString fUser; // user to be authenticated
76  Int_t fTimeOut; // timeout flag
77 
78  Int_t GenRSAKeys();
79  Bool_t GetPwHash() const { return fPwHash; }
80  Int_t GetRSAKey() const { return fRSAKey; }
81  ESecurity GetSecurity() const { return fSecurity; }
82  Bool_t GetSRPPwd() const { return fSRPPwd; }
83  const char *GetSshUser(TString user) const;
84  Int_t GetVersion() const { return fVersion; }
85  Int_t ClearAuth(TString &user, TString &passwd, Bool_t &pwhash);
86  Bool_t GetUserPasswd(TString &user, TString &passwd,
87  Bool_t &pwhash, Bool_t srppwd);
88  char *GetRandString(Int_t Opt,Int_t Len);
90  Int_t RfioAuth(TString &user);
91  void SetEnvironment();
92  Int_t SshAuth(TString &user);
93  Int_t SshError(const char *errfile);
94 
95  static TList *fgAuthInfo;
97  static Bool_t fgAuthReUse; // kTRUE is ReUse required
98  static TString fgDefaultUser; // Default user information
99  static TDatime fgExpDate; // Expiring date for new security contexts
102  static TString fgKrb5Principal; // Principal for Krb5 ticket
103  static TDatime fgLastAuthrc; // Time of last reading of fgRootAuthrc
105  static TPluginHandler *fgPasswdDialog; // Passwd dialog GUI plugin
106  static Bool_t fgPromptUser; // kTRUE if user prompt required
107  static TList *fgProofAuthInfo; // Specific lists of THostAuth fro proof
108  static Bool_t fgPwHash; // kTRUE if fgPasswd is a passwd hash
109  static Bool_t fgReadHomeAuthrc; // kTRUE to look for $HOME/.rootauthrc
110  static TString fgRootAuthrc; // Path to last rootauthrc-like file read
111  static Int_t fgRSAKey; // Default type of RSA key to be tried
112  static Int_t fgRSAInit;
113  static R__rsa_KEY fgRSAPriKey;
114  static R__rsa_KEY fgRSAPubKey;
115  static R__rsa_KEY_export* fgRSAPubExport; // array of size [2]
117  static Bool_t fgSRPPwd; // kTRUE if fgPasswd is a SRP passwd
118  static TString fgUser;
119  static Bool_t fgUsrPwdCrypt; // kTRUE if encryption for UsrPwd is required
120  static Int_t fgLastError; // Last error code processed by AuthError()
121  static Int_t fgAuthTO; // if > 0, timeout in sec
122  static Int_t fgProcessID; // ID of the main thread as unique identifier
123 
124  static Bool_t CheckHost(const char *Host, const char *host);
125 
126  static void FileExpand(const char *fin, FILE *ftmp);
127  static Int_t ProofAuthSetup(TSocket *sock, Bool_t client);
128  static void RemoveSecContext(TRootSecContext *ctx);
129 
130 public:
131  TAuthenticate(TSocket *sock, const char *remote, const char *proto,
132  const char *user = "");
133  virtual ~TAuthenticate() { }
134 
136  Int_t AuthExists(TString User, Int_t method, const char *Options,
137  Int_t *Message, Int_t *Rflag, CheckSecCtx_t funcheck);
138  void CatchTimeOut();
139  Bool_t CheckNetrc(TString &user, TString &passwd);
140  Bool_t CheckNetrc(TString &user, TString &passwd,
141  Bool_t &pwhash, Bool_t srppwd);
142  THostAuth *GetHostAuth() const { return fHostAuth; }
143  const char *GetProtocol() const { return fProtocol; }
144  const char *GetRemoteHost() const { return fRemote; }
145  Int_t GetRSAKeyType() const { return fRSAKey; }
147  TSocket *GetSocket() const { return fSocket; }
148  const char *GetUser() const { return fUser; }
149  Int_t HasTimedOut() const { return fTimeOut; }
150  void SetRSAKeyType(Int_t key) { fRSAKey = key; }
151  void SetSecContext(TRootSecContext *ctx) { fSecContext = ctx; }
152 
153  static void AuthError(const char *where, Int_t error);
154  static Bool_t CheckProofAuth(Int_t cSec, TString &det);
155 
156  static Int_t DecodeRSAPublic(const char *rsapubexport, R__rsa_NUMBER &n,
157  R__rsa_NUMBER &d, char **rsassl = 0);
158 
159  static TList *GetAuthInfo();
160  static const char *GetAuthMethod(Int_t idx);
161  static Int_t GetAuthMethodIdx(const char *meth);
162  static Bool_t GetAuthReUse();
163  static Int_t GetClientProtocol();
164  static char *GetDefaultDetails(Int_t method, Int_t opt, const char *user);
165  static const char *GetDefaultUser();
166  static TDatime GetGlobalExpDate();
167  static Bool_t GetGlobalPwHash();
168  static Bool_t GetGlobalSRPPwd();
169  static const char *GetGlobalUser();
171  static THostAuth *GetHostAuth(const char *host, const char *user="",
172  Option_t *opt = "R", Int_t *Exact = 0);
173  static const char *GetKrb5Principal();
174  static Bool_t GetPromptUser();
175  static TList *GetProofAuthInfo();
176  static Int_t GetRSAInit();
177  static const char *GetRSAPubExport(Int_t key = 0);
178  static THostAuth *HasHostAuth(const char *host, const char *user,
179  Option_t *opt = "R");
180  static void InitRandom();
181  static void MergeHostAuthList(TList *Std, TList *New, Option_t *Opt = "");
182  static char *PromptPasswd(const char *prompt = "Password: ");
183  static char *PromptUser(const char *remote);
184  static Int_t ReadRootAuthrc();
185  static void RemoveHostAuth(THostAuth *ha, Option_t *opt = "");
186  static Int_t SecureRecv(TSocket *Socket, Int_t dec,
187  Int_t KeyType, char **Out);
188  static Int_t SecureSend(TSocket *Socket, Int_t enc,
189  Int_t KeyType, const char *In);
190  static Int_t SendRSAPublicKey(TSocket *Socket, Int_t key = 0);
191  static void SetAuthReUse(Bool_t authreuse);
192  static void SetDefaultUser(const char *defaultuser);
193  static void SetGlobalExpDate(TDatime expdate);
194  static void SetGlobalPasswd(const char *passwd);
195  static void SetGlobalPwHash(Bool_t pwhash);
196  static void SetGlobalSRPPwd(Bool_t srppwd);
197  static void SetGlobalUser(const char *user);
198  static void SetGlobusAuthHook(GlobusAuth_t func);
199  static void SetKrb5AuthHook(Krb5Auth_t func);
200  static void SetPromptUser(Bool_t promptuser);
201  static void SetDefaultRSAKeyType(Int_t key);
202  static void SetReadHomeAuthrc(Bool_t readhomeauthrc); // for PROOF
203  static void SetRSAInit(Int_t init = 1);
204  static Int_t SetRSAPublic(const char *rsapubexport, Int_t klen);
205  static void SetSecureAuthHook(SecureAuth_t func);
206  static void SetTimeOut(Int_t to);
207  static void Show(Option_t *opt="S");
208 
209  ClassDef(TAuthenticate,0) // Class providing remote authentication service
210 };
211 
212 #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:64
TString fPasswd
Definition: TAuthenticate.h:65
static Bool_t fgUsrPwdCrypt
static TDatime fgExpDate
Definition: TAuthenticate.h:99
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:79
static Bool_t fgPromptUser
Int_t(* GlobusAuth_t)(TAuthenticate *auth, TString &user, TString &det)
Definition: TAuthenticate.h:42
const char Option_t
Definition: RtypesCore.h:62
TString fDetails
Definition: TAuthenticate.h:63
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:43
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:131
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 'sec' and user 'usr'.
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:47
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:95
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:71
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:41
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:44
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:80
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:84
TRootSecContext * fSecContext
Definition: TAuthenticate.h:70
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:81
static TList * GetAuthInfo()
Static method returning the list with authentication details.
#define d(i)
Definition: RSha256.hxx:102
static void SetAuthReUse(Bool_t authreuse)
Set global AuthReUse flag.
TString fProtocol
Definition: TAuthenticate.h:66
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:72
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
Definition: TAuthenticate.h:98
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:82
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]
Definition: TAuthenticate.h:96
const char * proto
Definition: civetweb.c:15049
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
Definition: TAuthenticate.h:97
TString fRemote
Definition: TAuthenticate.h:68
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.