EAServer’s authorization model is based on roles, which are defined in EAServer Manager. Each role can include and exclude specific user names or digital IDs. If you use native operating system authentication, you can also include and exclude operating system group names; all users in the specified group are affected.
Roles are attached to EAServer packages and components. A package or component’s role controls access as follows:
If any roles are assigned to a package, the user must have all of these roles to use any component in the package.
If any roles are assigned to a component, the user must have all of these roles to use the component.
If roles are assigned to both a component and the package that contains it, the user must have all of the roles that are assigned to the package and component.
You must either refresh or restart EAServer for any role changes to take effect.
Refreshing EAServer
Highlight the Roles folder.
Select File | Refresh.
Defining a new role
Highlight the Roles folder.
Select File | New Role. Enter the required information in the subsequent dialogs:
New Role – the name of the role you are defining.
Description – the description, up to 255 characters, of the role.
Owner – the owner of the role.
Deleting an existing role
Highlight the Roles folder. You see a list of existing roles.
Highlight the role you want to delete.
Right-click the role and select Delete. This option is available only to the owner of the role or the jagadmin user.
Click Yes to confirm deletion of the selected role.
Only the owner or a member of the role named Admin Role
can delete a role, except for Admin Role itself, which cannot be
deleted. See “Admin role in EAServer” for
more information.
Modifying an existing role
Highlight the Roles folder. You see a list of existing roles.
Highlight the role you want to modify.
Select File | Properties.
Make your modifications and click OK.
Adding an existing role, or creating and adding a new role
to a package, component, or method
Double-click the icon for the package, component, or method to expand the folders beneath it. Highlight the Role Membership folder.
Select File | Install Role. Then select one of the following options from the Role wizard:
Install an Existing Role – a list of uninstalled roles appears in the dialog. Highlight the role to be installed and click OK.
Create and Install a New Role – enter the name of the new role to be installed. Complete the role property sheet. The properties are described in “Defining a new role”.
A package, component, or method with
no roles or role memberships defined has no access restrictions.
Each role can include and exclude specific user names and digital IDs. If you use native operation system authentication, you can also include and exclude operating system group names; all users in the specified group are affected.
Assigning authorized users to a role of a component or a
package
Double-click the component or package to which the role belongs.
Highlight the Roles folder.
Double-click the role to which you want to add authorized users.
Highlight the Authorized User folder.
Select File | Add Authorized User.
Enter the name of the authorized user in the dialog, and click Add Authorized User. On Windows, you can provide the name of the domain as part of the authorized user name; for example, \\domain_name\user_name. The user is authenticated using the domain name controller for that domain.
The user’s name appears on the right side of the window when you highlight the Authorized Users folder.
To remove an existing authorized user, highlight the member and select File | Remove Member.
Assigning authorized groups to a role of a component or a
package
Double-click the component or package to which the role belongs.
Highlight the Roles folder.
Double-click the role to which you want to add authorized groups.
Highlight the Authorized Group folder.
Select File | Add Authorized Group.
Enter the name of the authorized group in the dialog, and click Add Authorized Group.
The group’s name appears on the right side of the window when you highlight the Authorized Groups folder.
To remove an existing authorized group, highlight the member and select File | Remove Member.
The users and groups of a role are mapped to operating
system users and groups. To validate users and groups, you must
click Enable User and Group Validation from the server’s
Security property sheet. You can only add validated groups to roles.
When Enable User and Group Validation is disabled, package and component
authorizations stop at the user level. There is no attempt to check
group level authorization.
Assigning authorized digital IDs (certificates) to a component
or a package
Double-click the component or package to which the role belongs.
Highlight the Roles folder.
Double-click the role to which you want to add authorized digital IDs.
Highlight the Authorized Digital IDs folder.
Select File | Add Authorized Digital ID.
A list of digital IDs appears. Double-click the name of the digital ID that you want to authorize, and click Add Authorized Digital ID.
Only certificates that appear in the EAServer Manager | Certificate folder | User Certificates folder and Other Certificates folder can be authorized. This requires that you install the certificate using EAServer Manager | Certificate folder. See Chapter 14, “Managing Keys and Certificates” for more information.
The user’s name appears on the right side of the window when the Authorized Digital IDs folder is highlighted.
To remove an existing authorized digital ID, highlight the member and select File | Remove Member.
You can verify, export, or view information about an authorized digital ID by highlighting the digital ID and selecting the corresponding option from the file menu. See Chapter 14, “Managing Keys and Certificates” for more information about these options.
Excluding users from a component or a package
Double-click the component or package to which the role belongs.
Highlight the Roles folder.
Double-click the role from which you want to exclude users.
Highlight the Excluded User folder.
Select File | Add Excluded User.
Enter the name of the excluded user in the dialog, and click Add Excluded User. On Windows, you can provide the name of the domain as part of the excluded user name; for example, \\domain_name\user_name. The user is authenticated using the domain name controller for that domain.
The user’s name appears on the right side of the window when the Excluded Users folder is highlighted.
To remove an existing excluded user, highlight the member and select File | Remove Member.
Excluding groups from a component or a package
Double-click the component or package to which the role belongs.
Highlight the Roles folder.
Double-click the role from which you want to exclude groups.
Highlight the Excluded Group folder.
Select File | Add Excluded Group.
Enter the name of the excluded group in the dialog box, and click Add Excluded Group.
The group’s name appears on the right side of the window when you highlight the Excluded Groups folder.
To remove an existing excluded group, highlight the member and select File | Remove Member.
Excluding digital IDs (certificates) from a component or
a package
Double-click the component or package to which the role belongs.
Highlight the Roles folder.
Double-click the role from which you want to exclude digital IDs.
Highlight the Excluded Digital IDs folder.
Select File | Add Excluded Digital ID.
A list of digital IDs appears. Double-click the name of the digital ID that you want to exclude, and click Add Excluded Digital ID.
Only certificates that appear in the EAServer Manager | Certificate folder | User Certificates folder and Other Certificates folder can be excluded. This requires you to install the certificate using EAServer Manager | Certificate folder. See Chapter 14, “Managing Keys and Certificates” for more information.
The user’s name appears on the right side of the window when the Excluded Digital IDs folder is highlighted.
To remove an existing excluded authorized digital ID, highlight the member and select File | Remove Member.
You can verify, export, or view information about an excluded digital ID by highlighting the digital ID and selecting the corresponding option from the file menu.
The following order is used to determine role based authorization:
If the user is authorized, the search terminates and authorization is granted.
If the user is excluded, the user is declined access to the resource.
If the user is in an authorized group:
Check if the role is a member of the authorized group.
If this check succeeds, check if the role is a member of an excluded group list—if not, grant access to the resource.
Excluded lists simplify the task of granting authorization to a small number of users by denying access to the users based on their user names and not the authorized groups to which they belong when using group-based authorization.
If a user is a member of an excluded user or group list,
EAServer does not invoke the Role Service (CtsSecurity/RoleService)
if defined for that server.
EAServer includes a number of predefined, read-only roles that you can use to facilitate authorization to EAServer resources. Role names are case sensitive and include:
ServiceControl Prevents clients from invoking service components.
anonymous Allows access to an ‘anonymous’ user.
everybody Allows access to all authenticated users.
system Prevents access by any client. The system user is a member, so components with this role can run as EAServer services.
nobody Prevents all access to a method or component. No user is a member of this role, not even the EAServer system user.
Every EAServer contains an Admin package and an Admin role. You must be a member of the Admin role to run EAServer Manager.
Initially, only jagadmin is a member of this role. The jagadmin user can set up additional members.
Even though other users can belong to the Admin role and run EAServer Manager, only the jagadmin user can:
Set the following options from EAServer Manager | Servers folder | server_name | Properties | Security tab:
The jagadmin password
Enable OS Authentication
Enable User & Groups Validation
Modify users, groups, or digital IDs belonging to the EAServer Manager | Roles | Admin role.
Granting permissions to EAServer roles
Beginning with EAServer 5.0, members of the Admin role can use EAServer Manager or jagtool to grant permissions to other EAServer roles; for example, permission to start or shut down a server.
In EAServer Manager, expand the Roles folder, highlight the role to which you want to grant permissions, right-click, and select Properties.
In the Role Properties dialog box, select any of the tabs described below.
Application Authorities To grant users with the current role permission to create, modify, or delete an application, select Add Application, and enter the application name.
To remove an application from the list of those that users with this role have permission to access, highlight the application name, and select Delete Application.
Package Authorities To grant users with the current role permission to create, modify, or delete a package, select Add Package, and enter the package name.
To remove a package from the list of those that users with this role have permission to access, highlight the package name, and select Delete Package.
Server Authorities To authorize users with the current role permission to perform an action on the server, select the action:
Restart Server
Refresh Server
Shut down Server
To revoke permission to perform an action, unselect the action.
Servlet Authorities To grant users with the current role permission to create, modify, or delete a servlet, select Add Servlet, and enter the servlet name.
To remove a servlet from the list of those that users with this role have permission to access, highlight the servlet name, and select Delete Servlet.
Web Application Authorities To grant users with the current role permission to create, modify, or delete a Web application, select Add Web Application, and enter the Web application name.
To remove a Web application from the list of those that users with this role have permission to access, highlight the Web application name, and select Delete Web Application.
For information about using jagtool to grant and revoke permissions, see the reference pages for the commands grantroleauth or removeroleauth in Chapter 12, “Using jagtool and jagant,” in the EAServer System Administration Guide.
| Copyright © 2005. Sybase Inc. All rights reserved. |
|
|