Adobe ColdFusion 8

IsUserInRole

Description

Determines whether an authenticated user belongs to the specified Role.

Returns

True, if the authenticated user, belongs to the specified Role; False, otherwise.

Category

Security functions, Decision functions

Function syntax

IsUserInRole("role_name")

See also

cflogin, cfloginuser, GetAuthUser, GetUserRoles, IsUserInAnyRole, IsUserLoggedIn, "Securing Applications" in the ColdFusion Developer's Guide

History

ColdFusion MX: Added this function.

Parameters

Parameter

Description

role_name

Name of a security role

Usage

Role names are not case-sensitive.

To check if a user is in multiple roles, specify them in a comma-delimited list, such as "Admin,HR". Lists with multiple roles cannot contain spaces as separators; for example, do not use "Admin, HR".

Example

<cfif IsUserInRole("Admin") > 
    <cfoutput>Authenticated user is an administrator</cfoutput> 
<cfelse IsUserInRole("User") > 
    <cfoutput>Authenticated user is a user</cfoutput> 
</cfif>