Searching for a Principal

Following are the methods to search for a principal:

Click List All in the Principals tab to display a list of principals in the current realm in the List of Principals list box, which displays up to 1,000 principals.
Click Search to display a list of principals in the current realm that match the search criteria in the Search String text box. The List of Principals dialog box displays up to 1,000 principals.

To search for a principal, complete the following steps:

In the Principals tab, select the Realm in which you want to search a principal.
Enter the search criteria for the principal in the Search String text box. The search string can contain wildcards.
Click Search to display the principal names that match your search criteria in the current realm.
The List of Principals list box displays a list of 1,000 principal names in the current realm that match your search criteria.

If you cannot find the principal name, refine your search using the search criteria described in Table 8-9 “Search Criteria”.

Table 8-9 Search Criteria

Character

Description

Represents any string of characters including / (slash). For example:

*/admin searches for all principal names with an admin instance.
*test* searches for all principals containing the characters test.

Each ? represents a single character except / (slash). For example:

test? searches for all principal names containing the characters test followed by a single character.
test?? searches for all principal names containing the characters test followed by any two characters.

[...]

Represents any one character from the set except / (slash). For example, [abc]* searches for all principal names starting with a, b, or c.

The following characters have a special meaning with the [...] construct:

!

Represents an exclusion when used immediately after [ .

For example:

[!abc]* searches for all principal names that start with any character other than a, b, or c.

[]a]* searches for all principal names that start with the character ] or a.

[!]a]* searches for all principal names that do not start with the character ] or a.

-

Represents a range of characters. When used immediately after [ or [!, or as the last character in the set, this character is matched literally. For example:

test [1-9] searches for all principal names starting with the characters test, followed by an one number is the range 1 through 9.

[abc-] searches for all principal names starting with a, b, c, or, “-”.

:

Represents the starting of a character class descriptor when used immediately after [ or [!. Otherwise, it is matched literally.

The following character classes are supported:

[:alnum:] [:alpha:] [:cntrl:] [:digit:] [:graph:] [:lower:] [:print:] [:punct:] [:space:] [:upper:] [:xdigit:]

Searching for a Principal

Technical documentation

» Table of Contents

» Glossary

» Index