CFLib.org – Common Function Library Project

getAuthUsername()

Last updated October 9, 2006
Download UDF

author

Mike Tangorre                                     Mike Tangorre

Version: 1 | Requires: ColdFusion 5 | Library: SecurityLib

Description:
Users have various ways of specifying their username when logging onto a network. The formats can be: username@some.domain, domain\username, or even just username. This function returns the username portion of the cgi.auth_user or cgi.remote_user variables. If neither cgi variable contains a value, an empty string is returned.

Return Values:
Returns a string.

Example:

<cfoutput>
#getAuthUsername()#
</cfoutput>

Parameters:

No arguments.

Full UDF Source:

<!---
Get the authenticated username from the cgi.auth_user or cgi.remote_user without the domain information.

@return Returns a string.
@author Mike Tangorre (mtangorre@gmail.com)
@version 1, April 9, 2007
--->

<cffunction name="getAuthUsername" returntype="string" output="false">
    
    <cfset var username = "" />
    
    <cfif len(trim(cgi.auth_user))>
    
        <cfset username = trim(cgi.auth_user) />
    
    <cfelseif len(trim(cgi.remote_user))>
    
        <cfset username = trim(cgi.remote_user) />
    
    <cfelse>
    
        <!--- no string to work with --->
        <cfreturn trim(username) />
    
    </cfif>
    
    <!--- check username@some.domain --->
    <cfif find("@",username)>
    
        <cfreturn listFirst(username,"@") />
    
    <!--- check domain\username --->
    <cfelseif find("\",username)>
    
        <cfreturn listLast(username,"\") />
    
    <!--- no domain --->
    <cfelse>
    
        <cfreturn trim(username) />
    
    </cfif>
    
</cffunction>

Search CFLib.org


Latest Additions

Raymond Compton Raymond Compton added
structBlend
19 day(s) ago

Duncan Duncan added
IsZIPUK
19 day(s) ago

Todd Sharp Todd Sharp added
getTagContentAll
25 day(s) ago

Gerald Guido Gerald Guido added
ListReturnDuplicat...
1 month(s) ago

Gerald Guido Gerald Guido added
ListReturnDuplicat...
1 month(s) ago

Created by Raymond Camden / Design by Justin Johnson