Skip to main content
Version: 4.12.x.x LTS

Navigating Patterns

Searching for Patterns

After you have added multiple patterns for your project, you will end up with a long list of patterns in the left part of the Projects screen. With the help of the search bar at the top of the patterns list, you can find any pattern you might need to work with. The next movie shows you how:

How to search for patterns

You can search for patterns by pattern name or pattern type. In both cases, start entering the pattern name or type in the input field of the search bar. All patterns fulfilling the search criteria will be listed below the search bar.

Filtering Patterns

If you want to filter your patterns, click the Filter icon on top of the pattern list and select the pattern category of your interest. The next movie shows you how:

How to filter patterns
  • You can select one or multiple pattern categories.
  • If you select multiple pattern categories, the result list will contain only those patterns that belong to all selected pattern categories.
  • If you close the Filter section by re-clicking on the Filter icon, the filter remains active. The pattern list will only contain the filtered results.

Sorting Patterns

If you want to sort your patterns in alphabetical or last edit order, click the Sorting icon on top of the pattern list and select one of the sorting options. By default the patterns are sorted in alphabetical order. If you change the sorting options, the last selected one is remembered. The following movie shows how to sort out the patterns:

How to sort out the patterns

Grouping the Patterns

You can change the view of the patterns list with the Group by function. The following options are available:

  • Ungrouped list -Shows the patterns in a flat list.
  • Label - Shows the patterns grouped by labels.

The following movie shows how to change the view of the patterns:

How to change the view of the patterns

Usage & Help

Usage

You can see relations between your patterns with the Usage section in the Help part on the right side of the screen. The Usage section lists all patterns that reference the selected pattern.

The following movie shows how to check the usage of your patterns:

How to check the usage of patterns

If you click on the link in the Usage section, you will be forwarded to the pattern in which your pattern is referenced. You can find more information about pattern references and usage in Editing Pattern Fields.

Authentication Flow

To see how your selected pattern is involved in the authentication flows, use the Authentication Flow function.

The Authentication Flow diagram represents the steps of the authentication flows in the given Authentication Realm. The tree structure shows the relations of the patterns in a hierarchical overview and provides an easy navigation between the related patterns.

The authentication flow tree only contains the patterns included in the steps of the authentication flows, as well as the application access tokens. The tree is drawn from the Authentication Realm pattern.

Note that any generic authentication state added to the authentication steps is not visible in the authentication flow diagram. The diagram represents only the patterns, not the generic authentication states. To display the authentication states in the graph, configure each of them in a separate Authentication Step pattern.

Take the following steps to use the function:

  1. Select one of the following patterns:
    1. Any Authentication Realm pattern.
    2. Any pattern referenced in the authentication flow of an Authentication Realm pattern.
    3. Any pattern referenced as application access token of an Authentication Realm pattern.
  2. Open the Usage & Help part on the right side of the screen.
  3. Select the Usage tab.
  4. Find the tree structure diagram in the Authentication Flow section.

A pattern can belong to multiple Authentication Realms. Use the Referenced realm dropdown menu in the Authentication Flow section to see if and how the selected pattern is used by other Authentication Realms. Such "shared" patterns are highlighted with the shared icon in the tree. When hovering over the shared icon, it shows the patterns/realms that also use this pattern.

You can easily navigate through the patterns in the tree by clicking on the pattern names.

The authentication flow can contain a loop in the referenced patterns. In such cases, you will see a loop icon next to the pattern from which the loop is started.

The following movie shows how to check the authentication flow:

How to check the authentication flow