> For the complete documentation index, see [llms.txt](https://help.security.gallagher.com/knowledge-hub/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.security.gallagher.com/knowledge-hub/configuration-client/licensable-features/cardholder-competencies/scenario-accessing-a-zone-restricted-by-cardholder-competencies.md).

# Scenario: Accessing a zone restricted by cardholder competencies

### Introduction

On many sites cardholders are required to have specific competencies before they can enter a particular Access Zone. These competencies may be as simple as the successful completion of a training programme, or may be associated with a specific credential, (e.g. a driver’s license). The competency may be a permanent competency once attained or it may be valid only between specified dates and requires renewal if the cardholder still requires access after the expiry date.

### Scenario

1. A cardholder presents a card at a reader controlling access to an Access Zone which is currently in a secure state.
2. The cardholder belongs to an Access Group, the members of which are allowed into the secure Access Zone at that time according to the Command Centre schedule.

<table><thead><tr><th width="270">The Access Zone has...</th><th width="300">A cardholder...</th><th>Result</th></tr></thead><tbody><tr><td>no competencies stipulated</td><td>Cardholder competencies are not checked in this scenario</td><td><ul><li>Access is granted,</li><li>Cardholder is notified,</li><li>Door unlocks.</li></ul></td></tr><tr><td rowspan="3"><p>a single competency stipulation that all cardholders must have:</p><ul><li><strong>completed site induction training</strong></li></ul></td><td>has the competency of "Site Induction" and this is still current</td><td><ul><li>Access is granted,</li><li>Cardholder is notified,</li><li>Door unlocks.</li></ul></td></tr><tr><td>does not have the competency of "Site Induction"</td><td><ul><li>Access is denied,</li><li>Cardholder is notified with the configured message,</li><li>Door remains secure.</li></ul></td></tr><tr><td>has the competency of "Site Induction" but this has expired, (e.g. 6 month employment contract)</td><td><ul><li>Access is denied,</li><li>Cardholder is notified with message <em>"Access denied. Employment expired"</em> or similar,</li><li>Door does not unlock.</li></ul></td></tr><tr><td rowspan="3"><p>a competency stipulation that all cardholders must have:</p><ul><li><strong>completed site induction training, and</strong></li><li><strong>have a current medical certificate</strong></li></ul></td><td>has the current competency of "Site Induction" and the competency of a valid "Medical Certificate" that has not expired</td><td><ul><li>Access is granted,</li><li>Cardholder is notified,</li><li>Door unlocks.</li></ul></td></tr><tr><td>has the current competency of "Site Induction" but has never had a valid "Medical Certificate" competency</td><td><ul><li>Access is denied,</li><li>Cardholder is notified with message <em>"Access denied. Medical Cert missing. Contact HR Dept"</em> or similar,</li><li>Door remains secure.</li></ul></td></tr><tr><td>has the current competency of "Site Induction" and does have the competency of a valid "Medical Certificate" but this has expired</td><td><ul><li>Access is denied,</li><li>Cardholder is notified with message <em>"Access denied. Medical Cert expired. Contact HR Dept"</em> or similar,</li><li>Door remains secure.</li></ul></td></tr><tr><td rowspan="2">at least one <strong>Access Group</strong> defined as being <strong>competency-exempt</strong>. The cardholder does not have any of the competencies required for access to the zone</td><td>is a member of the <strong>competency-exempt</strong> Access Group</td><td><ul><li>Access is granted,</li><li>Cardholder is notified,</li><li><p>Door unlocks.</p><p>(The cardholder's competencies are not checked in this scenario)</p></li></ul></td></tr><tr><td>is not a member of a <strong>competency-exempt</strong> Access Group for the Access Zone</td><td><ul><li>Access is denied,</li><li>Cardholder is notified with appropriate <em>"Access denied"</em> message,</li><li>Door remains secure.</li></ul></td></tr><tr><td rowspan="3"><p>a competency stipulation that all cardholders must have completed at least one of:</p><ul><li><strong>site induction training, OR</strong></li><li><strong>company induction training</strong></li></ul></td><td>has the current competency of "Site Induction" and the competency of "Company Induction"</td><td><ul><li>Access is granted,</li><li>Cardholder is notified,</li><li>Door unlocks.</li></ul></td></tr><tr><td>has the current competency of "Company Induction" but does not have the "Site Induction" competency</td><td><ul><li>Access is granted,</li><li>Cardholder is notified,</li><li>Door unlocks.</li></ul></td></tr><tr><td>has neither the competency of "Site Induction" nor "Company Induction"</td><td><ul><li>Access is denied,</li><li>Cardholder is notified with the configured message,</li><li>Door remains secure.</li></ul></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.security.gallagher.com/knowledge-hub/configuration-client/licensable-features/cardholder-competencies/scenario-accessing-a-zone-restricted-by-cardholder-competencies.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
