Use an import-based transition when the immediate need is to test, bootstrap, or migrate existing authorization data quickly. It is especially useful when the current application has a working data model but the authorization logic is hard to maintain. This approach reduces initial integration effort while giving teams a controlled path toward a centralized authorization model.
Why an import-based transition is the pragmatic choice
An import-based transition fits situations where the team already has authorization data, policy mappings, or entitlement relationships that can be reused, but the current integration path is too costly to rebuild immediately. The key advantage is speed with control: you preserve existing state, reduce initial engineering effort, and create a path to normalize the model later without freezing the migration project.
This is most valuable when the current authorization logic is functionally correct but operationally hard to maintain, especially if the application has accumulated bespoke rules, brittle joins, or tightly coupled code paths. In that case, rebuilding the integration first can prolong risk and delay any move to a more centralized model, while import lets teams decouple migration from redesign.
Practically, the transition should be treated as a temporary mechanism, not the final architecture. The import step is useful when the priority is to establish a working baseline quickly, validate mappings, and reduce the chance that a complex rewrite introduces new authorization defects. For broader identity and access governance context, NHIMG’s Ultimate Guide to NHIs and the NHI Lifecycle Management Guide cover how lifecycle, ownership, and transition discipline affect ongoing access control quality.
When organizations are moving authorization data from one system to another, import also helps preserve continuity for dependent applications. That matters when the business cannot tolerate a long remediation window, or when the migration needs to happen before the target authorization design is fully mature. If the existing model is stable enough to migrate but expensive to evolve in place, import is usually the lower-risk first step.
Where import transitions outperform custom integrations
Import-based transitions are strongest when the organization needs a controlled bridge from legacy authorization to a newer platform. They work well for migration, bootstrap, proof-of-concept work, and cases where data quality can be improved incrementally after the first cutover. The import path is also preferable when the alternative would require a large custom integration that must be maintained indefinitely.
- Use import when the main challenge is getting existing authorization state into a new model quickly.
- Use import when you need to validate whether the centralized model can represent current entitlements before committing to a redesign.
- Use import when operational pressure is high and delay itself creates more risk than a staged transition.
- Avoid import-only thinking if the source data is so inconsistent that the migration would simply replicate bad policy at scale.
The better the current data model, the more attractive import becomes. If roles, permissions, groups, or policy assignments are already reasonably structured, import can preserve that structure while exposing where cleanup is needed. If the model is already deeply entangled or undocumented, import still helps, but the organization should expect remediation work after the initial load rather than trying to perfect the model up front.
For practitioners managing non-human access as part of the transition, the practical lesson is to normalize the migration path around ownership, rotation, and revocation expectations. NHIMG’s Lifecycle Processes for Managing NHIs is useful background when imported authorization data includes service accounts, API keys, or other machine-facing access paths that must be governed after the move.
Standards & Framework Alignment
This section maps relevant standards and security frameworks to the operational risks and controls described in this guidance.
OWASP Non-Human Identity Top 10 address the attack and risk surface, while CIS Controls v8 and NIST CSF 2.0 set the governance and control requirements practitioners need to meet.
| Framework | Control / Reference | Relevance |
|---|---|---|
| CIS Controls v8 | 6 — Access Control Management | Importing authorization data directly affects account and entitlement control. |
| Recommendation — Apply CIS Control 6 to validate and govern imported access paths before cutover. | ||
| NIST CSF 2.0 | PR.AC — Identity Management, Authentication and Access Control | The transition changes how access is represented and enforced across systems. |
| Recommendation — Use PR.AC to keep imported permissions aligned to least privilege and approved access. | ||
| OWASP Non-Human Identity Top 10 | NHI-01 — Secrets and Credential Sprawl | Imported authorization data may include machine-facing credentials or tokens. |
| NHI-02 — Excessive Privileges | Imported entitlements can preserve overbroad access if source data is not cleaned. | |
| NHI-07 — Lifecycle and Offboarding | A transition must preserve revocation and ownership for authorization records. | |
| Recommendation — Control imported secrets and rotate any exposed machine credentials during migration. Reduce imported privileges to the minimum needed before relying on the new model. Ensure imported identities and access grants have clear ownership and revocation handling. | ||
Practitioner Guidance
What to prioritise: Treat the import as a migration control, not a final-state control. The first priority is whether the imported data can faithfully represent who or what is authorized today, because bad source data will carry forward into the new model.
What to verify: Confirm that imported entitlements can be traced back to an owner, a purpose, and a revocation path. If those three cannot be established, the transition may still be feasible, but the imported state should be considered provisional until it is cleaned up.
Decision rule: If the current integration would require a long custom build before any value appears, choose import first; if the source authorization model is so fragmented that it cannot be normalized into a stable baseline, pause and remediate the data model before scaling the import.
Practitioner takeaway: The right question is not whether import is less elegant than a custom build, but whether it gets you to a governable baseline faster without locking in a broken access model.
Related resources from NHI Mgmt Group
- When should organisations prioritise file-based or database-based ingestion over building a custom connector?
- When should organisations prioritise an external authorization system over Keycloak’s built-in permissions model?
- When should organisations prioritise fast cached authorization over fully consistent checks?
- When should organisations prioritise flexible authorization over simple role models?