XrdSecgsiRtag.hh File Reference

#include <cstring>
#include "XrdCrypto/XrdCryptoFactory.hh"
#include "XrdCrypto/XrdCryptoMsgDigest.hh"

Include dependency graph for XrdSecgsiRtag.hh:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros
#define	kXRSrtagCtx   "XRD-GSI-RTAG-v1"
#define	kXRSrtagLen   8
#define	kXRSrtagMD   "sha256"
#define	kXRSrtagMDMax   64

Functions
int	XrdSecgsiRtagDigest (XrdCryptoFactory *cf, const char *rtag, int len, char *out, int outmax)
bool	XrdSecgsiRtagIsValid (const char *rtag, int len)

Macro Definition Documentation

kXRSrtagCtx

#define kXRSrtagCtx   "XRD-GSI-RTAG-v1"

Definition at line 59 of file XrdSecgsiRtag.hh.

Referenced by XrdSecgsiRtagDigest().

kXRSrtagLen

#define kXRSrtagLen   8

Definition at line 55 of file XrdSecgsiRtag.hh.

Referenced by XrdSecgsiRtagIsValid().

kXRSrtagMD

#define kXRSrtagMD   "sha256"

Definition at line 63 of file XrdSecgsiRtag.hh.

Referenced by XrdSecgsiRtagDigest().

kXRSrtagMDMax

#define kXRSrtagMDMax   64

Definition at line 67 of file XrdSecgsiRtag.hh.

Function Documentation

XrdSecgsiRtagDigest()

int XrdSecgsiRtagDigest ( XrdCryptoFactory * cf, const char * rtag, int len, char * out, int outmax )

inline

Definition at line 88 of file XrdSecgsiRtag.hh.

{
   // Fill out with the context bound digest of rtag, that is
   // SHA-256(kXRSrtagCtx || rtag). Return the number of bytes written,
   // or -1 in case of error.
 
   if (!cf || !rtag || len <= 0 || !out) return -1;
 
   // The factory returns a valid and initialized digest, or null
   XrdCryptoMsgDigest *md = cf->MsgDigest(kXRSrtagMD);
   if (!md) return -1;
 
   int lout = -1;
 
   if (md->Update(kXRSrtagCtx, (int)strlen(kXRSrtagCtx)) == 0 &&
       md->Update(rtag, len) == 0 && md->Final() == 0 &&
       md->Length() > 0 && md->Length() <= outmax) {
      lout = md->Length();
      memcpy(out, md->Buffer(), lout);
   }
 
   delete md;
 
   return lout;
}

References XrdCryptoBasic::Buffer(), XrdCryptoMsgDigest::Final(), kXRSrtagCtx, kXRSrtagMD, XrdCryptoBasic::Length(), XrdCryptoFactory::MsgDigest(), and XrdCryptoMsgDigest::Update().

Here is the call graph for this function:

XrdSecgsiRtagIsValid()

bool XrdSecgsiRtagIsValid ( const char * rtag, int len )

inline

Definition at line 70 of file XrdSecgsiRtag.hh.

{
   // Return true if rtag holds a well formed GSI random tag, that is
   // exactly kXRSrtagLen characters in the set [a-zA-Z0-9./].
 
   if (!rtag || len != kXRSrtagLen) return false;
 
   for (int i = 0; i < len; i++) {
      const char c = rtag[i];
      if ((c >= 'a' && c <= 'z') || (c >= 'A' && c <= 'Z') ||
          (c >= '0' && c <= '9') || c == '.' || c == '/') continue;
      return false;
   }
 
   return true;
}

References kXRSrtagLen.