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 61 of file XrdSecgsiRtag.hh.

Referenced by XrdSecgsiRtagDigest().

kXRSrtagLen

#define kXRSrtagLen   8

Definition at line 57 of file XrdSecgsiRtag.hh.

Referenced by XrdSecgsiRtagIsValid().

kXRSrtagMD

#define kXRSrtagMD   "sha256"

Definition at line 65 of file XrdSecgsiRtag.hh.

Referenced by XrdSecgsiRtagDigest().

kXRSrtagMDMax

#define kXRSrtagMDMax   64

Definition at line 69 of file XrdSecgsiRtag.hh.

Function Documentation

XrdSecgsiRtagDigest()

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

inline

Definition at line 87 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 72 of file XrdSecgsiRtag.hh.

{
   // Return true if rtag holds a well formed GSI random tag, that is
   // exactly kXRSrtagLen bytes of 7-bit ASCII. The length is what keeps
   // the signature safe; the byte range follows the known generators.
 
   if (!rtag || len != kXRSrtagLen) return false;
 
   for (int i = 0; i < len; i++)
      if (static_cast<unsigned char>(rtag[i]) > 0x7f) return false;
 
   return true;
}

References kXRSrtagLen.