Skip to main content

Personnel Security


Personnel Security: Managing Clearances, Investigations, and Access in Government

The Personnel Security module provides a comprehensive data model for managing the people, processes, and events that make up a federal agency’s security program. In government, safeguarding facilities, information, and systems depends on far more than issuing badges—it requires a coordinated set of checks, investigations, clearances, and ongoing monitoring. This module captures those activities in a consistent, auditable structure that can be used on its own or integrated with other government data models.

The foundation of the module is the Person table, which represents employees, contractors, visitors, or other individuals subject to security vetting. People can be linked to Organization Units and Location records, establishing where they work, what office they belong to, and where they need access. From there, the model supports the investigative and adjudicative lifecycle used by security teams.

To preserve identity and contact details across the investigative lifecycle, the module integrates with the core Personal Information record. A lookup from core Personal Information links back to Personnel Background Investigation, and the Person on a Background Investigation maps to the Person on Personal Information — enabling consistent person-level identity and investigation linkage across systems.

A new Personnel CV Trigger table captures continuous vetting and other trigger events (feeds, alerts, referrals) that should prompt review. Those triggers can spawn or be associated with a Personnel Background Investigation, which now includes a Background Investigation Type choice (for example: Initial, Reinvestigation, Continuous Evaluation, Suitability Review) to classify the investigative intent. Investigations can produce or be linked to Personnel Clearance records — a new table that tracks clearance status, granting authority, effective and expiration dates, and historical changes. Clearances and investigations flow into Personnel Adjudication where determinations, findings, and actions are recorded; field mappings and lookups are provided across these tables to keep a complete audit trail.

On the operational side, the model continues to manage access requests and credentials through Personnel Badge Request, Personnel Physical Credential, and Personnel Visitor Request, tying those operational events back to a person’s investigative and clearance state when necessary.

Risk detection and monitoring are supported through Personnel Reportable Life Event, Personnel Foreign Contact, and Personnel Foreign Travel, which capture the types of events and exposures that may affect suitability for access. To make those events more actionable, this release adds standardized choice lists such as Intelligence Source (to record the origin of an alert or feed) and Personnel Security Event Type (to categorize the nature of the event).

Finally, Personnel Passport keeps records of passports issued, controlled, or monitored by the agency — a necessity in organizations that sponsor official travel or manage sensitive assignments abroad.

graph TD
  Account(Account)
  Contact(Person)
  govcdm_Document(Document)
  govcdm_Location(Location)
  govcdm_organizationunit(Organization Unit)
  govcdm_PersonalInformation(Personal Information)
  govcdm_PersonnelAdjudication(Personnel Adjudication)
  govcdm_PersonnelBackgroundInvestigation(Personnel Background Investigation)
  govcdm_PersonnelBadgeRequest(Personnel Badge Request)
  govcdm_PersonnelClearance(Personnel Clearance)
  govcdm_PersonnelCVTrigger(Personnel CV Trigger)
  govcdm_PersonnelForeignContact(Personnel Foreign Contact)
  govcdm_PersonnelForeignTravel(Personnel Foreign Travel)
  govcdm_PersonnelPassport(Personnel Passport)
  govcdm_PersonnelPhysicalCredential(Personnel Physical Credential)
  govcdm_PersonnelReportableLifeEvent(Personnel Reportable Life Event)
  govcdm_PersonnelVisitorRequest(Personnel Visitor Request)
  SystemUser(User)
  govcdm_PersonnelBackgroundInvestigation --> Account
  govcdm_PersonalInformation --> Contact
  govcdm_PersonnelAdjudication --> Contact
  govcdm_PersonnelAdjudication --> Contact
  govcdm_PersonnelBackgroundInvestigation --> Contact
  govcdm_PersonnelBackgroundInvestigation --> Contact
  govcdm_PersonnelClearance --> Contact
  govcdm_PersonnelCVTrigger --> Contact
  govcdm_PersonnelForeignContact --> Contact
  govcdm_PersonnelForeignTravel --> Contact
  govcdm_PersonnelPassport --> Contact
  govcdm_PersonnelPhysicalCredential --> Contact
  govcdm_PersonnelPhysicalCredential --> Contact
  govcdm_PersonnelPhysicalCredential --> Contact
  govcdm_PersonnelPhysicalCredential --> Contact
  govcdm_PersonnelReportableLifeEvent --> Contact
  govcdm_PersonnelVisitorRequest --> Contact
  govcdm_PersonnelAdjudication --> govcdm_Document
  govcdm_PersonnelBackgroundInvestigation --> govcdm_Document
  govcdm_PersonnelPhysicalCredential --> govcdm_Location
  govcdm_PersonnelPhysicalCredential --> govcdm_organizationunit
  govcdm_PersonnelBackgroundInvestigation --> govcdm_PersonnelAdjudication
  govcdm_PersonnelClearance --> govcdm_PersonnelAdjudication
  govcdm_PersonalInformation --> govcdm_PersonnelBackgroundInvestigation
  govcdm_PersonnelAdjudication --> govcdm_PersonnelBackgroundInvestigation
  govcdm_PersonnelBackgroundInvestigation --> govcdm_PersonnelBackgroundInvestigation
  govcdm_PersonnelClearance --> govcdm_PersonnelBackgroundInvestigation
  govcdm_PersonnelCVTrigger --> govcdm_PersonnelBackgroundInvestigation
  govcdm_PersonnelForeignContact --> govcdm_PersonnelBackgroundInvestigation
  govcdm_PersonnelForeignTravel --> govcdm_PersonnelBackgroundInvestigation
  govcdm_PersonnelPassport --> govcdm_PersonnelBackgroundInvestigation
  govcdm_PersonnelReportableLifeEvent --> govcdm_PersonnelBackgroundInvestigation
  govcdm_PersonnelAdjudication --> govcdm_PersonnelClearance
  govcdm_PersonnelBackgroundInvestigation --> govcdm_PersonnelClearance
  govcdm_PersonnelCVTrigger --> govcdm_PersonnelClearance
  govcdm_PersonnelBackgroundInvestigation --> govcdm_PersonnelCVTrigger

Requirements

Install the latest managed version of Government Data Models - Core first.

Next, install the latest managed version of Government Data Models - Process and Tasking.

Location

Represents a physical or logical location relevant to personnel security.

Organization Unit

Represents an organizational unit to which a person belongs or is associated for security purposes.

Person

Represents an individual subject to security vetting, such as employees, contractors, or visitors.

Personal Information

Personal information entries used for applications, background checks, and other processing.

Personnel Adjudication

Records the determination of a person's eligibility for access or clearance.

Personnel Background Investigation

Tracks background investigations conducted for personnel security.

Personnel Badge Request

Tracks requests for physical access devices such as ID cards or badges.

Personnel CV Trigger

Tracks CV (continuous vetting) trigger events and intel sources that prompt review or investigation.

Personnel Clearance

Tracks personnel clearance status, level, eligibility and history.

Personnel Foreign Contact

Records declared foreign contacts for counterintelligence and risk monitoring.

Personnel Foreign Travel

Captures declared foreign travel for counterintelligence and risk monitoring.

Personnel Passport

Records passports issued, controlled, or monitored by the agency.

Personnel Physical Credential

Tracks issuance and management of physical credentials such as ID cards or smart credentials.

Personnel Reportable Life Event

Captures significant life events that may affect a person's security eligibility.

Personnel Visitor Request

Tracks requests for visitor access, including pre-approval and site coordination.

We highly recommend using the managed versions, which will allow you to easily update and uninstall the solution from your environment. If you need to modify or enhance the managed solution, you can can create a new solution, add the components to that solution and make changes as needed.

Gov Personnel Security Data Model v1.0.1.0

Adds Background Investigation Type choice; expands Background Investigation with many fields and mappings; introduces Personnel Clearance and Personnel CV Trigger tables; adds new choice lists for Intelligence Source and Personnel Security Event Type; updates lookups and mappings across related tables.

Gov Personnel Security Data Model v1.0.0.2

Adds Expected Return Date, Actual Return Date, and a 'Returned To' lookup to Person on the Personnel Physical Credentials

Gov Personnel Security Data Model v1.0.0.1

Introduces Personnel Physical Credential table, adds Person lookups to several tables, new choice values for credential and adjudication types, quick-create forms, and icons.

Gov Personnel Security Data Model v1.0.0.0

Baseline personnel security data model release containing initial tables for adjudication, investigations, passports, and related personnel workflows.

Download Latest Release (v1.0.1.0)

Requires data models

Related use cases

Related personas

This is an open-source project maintained by Microsoft. It is not an official U.S. government website. The site uses the U.S. Web Design System (USWDS) to help agencies and partners create app catalog documentation sites of their own. Open Source at Microsoft