Profile Master Configuration Strategy in Okta

Profile Master Configuration Strategy in Okta

Every fact about a person lives somewhere first. Their name, manager, job title and phone number each have one rightful source, and when two systems disagree, someone must decide who wins. A first-principles guide to choosing profile masters, setting priorities and keeping identity data honest with Okta.

Alderbrook Health Network employs 12,000 people across forty clinics. On Monday, Priya, a nurse manager, gets married and changes her last name. HR updates her record that afternoon. By Tuesday, her email still shows the old name, the staff directory shows the new one, and the badge printer has produced a card with a third spelling. A patient asks the front desk for her by name and nobody can find her. Meanwhile her manager, Dev, has moved to another clinic, yet the approval requests for her time sheets still go to his old inbox.

Nobody made a mistake on purpose. Each system simply believed it was the keeper of the truth. HR thought it owned names. The directory team thought it owned email. The clinic app let local managers edit titles by hand. When Okta pulled data from all of them, it received three answers to the question “What is Priya’s name?” and had no rule for choosing between them. So it kept whichever answer arrived last.

The cure is a decision, written down and enforced: for each attribute, one system is the profile master. Only that source is allowed to change the value, and every other system receives it. Choosing masters sounds simple. In practice it needs careful thought about who really knows each fact, how fresh it must be, what happens when the master is wrong, and what to do when the master is silent. Okta provides settings to express these choices, and the details change over time, so every Okta-specific statement here is guidance to confirm against current official documentation. What does not change is the strategy: how to decide, how to configure, how to test and how to keep the arrangement healthy for years. We start from zero and assume no earlier knowledge.

1Why Profile Mastering Matters

Identity data feeds almost every decision a company makes about a person. If the data is wrong, the decisions are wrong.

Where Profile Data Is Used

Use

Access decisions

Department, location and job code decide which groups and applications a person receives.

Use

Approvals

The manager field decides who approves requests and reviews. A stale manager sends approvals to the wrong person.

Use

Communication

Name, email and phone appear in directories, messages and signatures.

Use

Security and audit

Employment status and dates decide when access must end, and auditors check them.

Because so much depends on profile data, mistakes spread quickly. A wrong department can grant a stranger access to payroll. A missed end date can leave a former employee’s account active for months.

Analogy

A library catalog tells every reader where each book sits. If two librarians keep separate catalogs and both change entries freely, readers will walk to empty shelves. One catalog, one keeper for each section, and clear rules for corrections keep the library useful.

2What a Profile Master Is, and Is Not

The term is used loosely. A clear definition prevents long meetings about different things.

What It Is

A profile master is the system that is allowed to create and change a given piece of profile data, and whose version is treated as the truth by everything else. In Okta, the idea appears in two forms. One is about the whole person: which source owns the user account and its lifecycle. The other is about single attributes: which source owns the value of each field.

What It Is Not

  • It is not just a data source. Many systems can supply data. Only the master is allowed to win a disagreement.
  • It is not a backup. Copies in other systems are consumers, not equals.
  • It is not the most convenient system. The master should be the one that truly knows, not the one that is easiest to connect.
  • It is not permanent. Mergers, new tools and reorganizations change who knows best.
  • It is not an access rule. It decides whose data is trusted, not who may see it.
Analogy

A birth certificate office is the master for a person’s date of birth. A school, a bank and a clinic all hold copies. If a copy disagrees, nobody asks the school. They go back to the office that issued the record.

3Core Concepts: The Vocabulary of Mastering

A short dictionary makes the rest of the guide easier.

TermPlain meaning
Universal DirectoryOkta’s central store of user profiles and their attributes
AttributeOne field in a profile, such as title or phone
Profile sourceA system that supplies users and attributes to Okta, such as an HR system or a directory
Profile masterThe system whose values for a person or attribute win
Okta-masteredThe value is edited and owned inside Okta
Application-masteredThe value is owned by an outside application and flows into Okta
ImportPulling data from a source into Okta
PushSending data from Okta out to an application
MappingThe rule that connects a field in one profile to a field in another
PriorityThe ordering that decides which source wins when several supply the same attribute
ReconciliationComparing two copies and fixing differences
Source of truthThe agreed authority for a fact
Analogy

Learning the names of the parts before repairing a bicycle is not wasted time. You cannot follow the instructions about the derailleur until you know what it is.

4Universal Directory and the Okta Profile

Every strategy depends on understanding where the data lands.

Okta keeps one profile per person in its Universal Directory. The profile has a base set of attributes, such as first name, last name, email, department, manager and employee number, and it can hold custom attributes that you define. Each application you connect has its own separate user profile too, and mappings translate between the two.

flowchart LR
    HR["HR system"] -->|"Import"| UD["Okta Universal Directory profile"]
    AD["Corporate directory"] -->|"Import"| UD
    APP["Business application"] -->|"Import"| UD
    UD -->|"Push through mappings"| A1["Email service"]
    UD -->|"Push through mappings"| A2["Collaboration tool"]
    UD -->|"Push through mappings"| A3["Business application"]
    
Figure 1. Data flows into the Okta profile from sources and out to applications. Mastering decides which arrows are allowed to change which attributes.
  • One person, one Okta profile. Several sources may feed it.
  • Many application profiles. Each is a view of the person in that app.
  • Mappings are the wiring. They say which field feeds which, in which direction.
Analogy

Think of a school’s main student record, with a separate card for each club. The main record is the full picture, and each card shows what that club needs. When the main record changes, the cards should follow, not the other way around.

5Kinds of Profile Sources

Different systems are good at different facts. Knowing the strengths of each source guides the choice of master.

Source typeUsually best atUsually weak at
HR systemLegal name, hire and end dates, job, manager, employee typeEmail, phone numbers, technical identifiers
Corporate directory (such as an on-premises directory)Account names, group membership, local sign-in detailsBusiness facts, which are often stale
Okta itselfContact details people maintain, custom attributes, company-wide flagsFacts that already live in HR
Business applicationFacts only that app understands, such as sales region or license typeAnything about employment status
Contractor or vendor systemExternal worker details and contract datesEmployee-level data
Customer systemCustomer profile and consent detailsWorkforce details

Okta offers integrations for many HR systems and directories, and it can treat some applications as sources. Which ones are available, and how much of the profile they may master, depends on the product and edition, so confirm in current documentation.

Analogy

A newspaper gets sports scores from the sports desk and weather from the forecasters. It does not ask the weather team about a football result, however friendly they are.

6Whole-User Mastering Versus Attribute-Level Mastering

There are two different questions that sound alike: who owns the person, and who owns each fact about the person.

Whole-user mastering

  • One source creates, updates and deactivates the user
  • Simple to explain and audit
  • Fits clean cases, such as employees from one HR system

Where it falls short

  • Real data is rarely owned by a single system
  • Forces awkward workarounds for contact details or custom fields
  • Mergers add a second HR system and break the model

Attribute-level mastering

  • Each attribute can have its own owner and priority order
  • Models reality more closely
  • Allows an HR system and a directory to share the load

Cost

  • More rules to design, test and document
  • More ways for settings to conflict
  • Needs a clear owner for the attribute map
i
Tip

Start with the simplest model that fits. Use whole-user mastering for the lifecycle and attribute-level exceptions only where the data truly lives somewhere else. Confirm the current attribute-level options for your edition.

Analogy

A family can have one person who manages the household accounts, while another keeps the medical records and a third the school papers. One person owning everything is easy to explain, and sharing by topic is closer to real life.

7Okta-Mastered and Application-Mastered Attributes

Every attribute in an application’s mapping is either controlled by Okta or controlled from the outside. Getting this wrong causes the most common confusion.

ModeWho edits the valueDirection of flowGood for
Okta-masteredOkta, or a source feeding OktaOkta pushes to the applicationNames, titles and departments pushed to many apps
Application-masteredThe applicationApplication imports into OktaFacts only the app knows
Mixed by attributeDepends on the fieldBoth directions, different fieldsMost real integrations

The Typical Trap

A team turns on import from an application but leaves the old push rules on. Now both directions run, each overwrites the other, and values flip back and forth overnight. Every attribute must have exactly one direction at any time. When you list your attributes in a table, add a column for direction and review it with the owner of each application.

Analogy

Two people editing the same shared note, each copying the other’s version over their own, will argue forever about the contents. One writes and the other reads.

8Architecture and Components

A picture of the parts shows where decisions are made and where mistakes can enter.

flowchart TD
    S1["HR system"] --> I1["Import and matching"]
    S2["Corporate directory"] --> I1
    S3["Applications as sources"] --> I1
    I1 --> PR["Priority and mastering rules"]
    PR --> UD["Universal Directory profile"]
    UD --> M["Attribute mappings"]
    M --> P1["Provisioning to applications"]
    UD --> GR["Groups and policies"]
    UD --> LOG["System Log and reports"]
    PR --> LOG
    
Figure 2. Import, matching and priority rules sit before the profile. Mappings and provisioning sit after it.
  • Sources provide raw facts.
  • Matching decides which incoming record belongs to which person.
  • Priority rules decide which source wins for each attribute.
  • Universal Directory holds the resulting profile.
  • Mappings carry values on to applications.
  • Groups and policies use the profile to grant access.
  • Logs record what changed and why.
Analogy

A newsroom collects stories from reporters, an editor decides which version to print, and the press sends it to many readers. Mistakes caught at the editor’s desk cost far less than mistakes found after printing.

9Internal Working: One Profile Change Step by Step

Following one change from source to application removes most of the mystery.

sequenceDiagram
    participant HR as HR system
    participant OK as Okta import
    participant PR as Priority rules
    participant UD as Okta profile
    participant APP as Application
    HR->>OK: Priya's last name changed
    OK->>OK: Match record to Priya's profile
    OK->>PR: Compare with current value and source
    PR->>PR: Is HR the master for last name?
    PR-->>UD: Yes, update last name
    UD->>APP: Push new name through mapping
    APP-->>UD: Confirmation or error
    UD->>UD: Record the event in the log
    
Figure 3. A name change travels from HR to Okta and on to every connected application.
  1. The source system changes a value.
  2. Okta imports the change on a schedule or when triggered.
  3. Matching finds the right person, using a stable identifier.
  4. Priority rules ask whether this source may change this attribute.
  5. If yes, the Okta profile is updated.
  6. Mappings push the new value to applications that use it.
  7. Logs record each step for support and audit.

If any step is slow or fails, the change is delayed. That is why both the schedule of imports and the health of pushes matter as much as the rules themselves.

Analogy

A change of address travels from the postal register to the bank, the doctor and the school. If one of them never gets the letter, the parcels go to the old house.

10Matching: Knowing Which Record Is Which Person

Mastering rules are useless if records are matched to the wrong person. Matching is the quiet foundation.

Good and Poor Matching Keys

KeyQualityWhy
Employee numberStrongStable and unique, assigned by HR
Immutable system IDStrongNever reused or changed
Email addressMediumChanges with names and mergers; may be reused
Full nameWeakDuplicates, spelling differences and name changes
Phone numberWeakShared and changes often
  • Pick one stable key and use it everywhere. An employee number is better than a name.
  • Never reuse keys. A new person receiving a former employee’s number can inherit that person’s access.
  • Plan for no match. Decide whether an unmatched record creates a new profile or waits for review.
  • Plan for two matches. Duplicates must be flagged, not guessed.
Analogy

A hospital matches patients by a number, not just a name, because two different people called Anita Sharma should never share a chart.

11The Attribute Ownership Map

The single most useful document in a mastering project is a table that names the owner of every attribute.

AttributeMasterWhyFlowFreshness needed
Legal first and last nameHRLegal recordsHR to Okta to appsDaily
Preferred nameOkta (self-service)Chosen by the personOkta to appsHours
Employee numberHRAssigned by HRHR to OktaDaily
ManagerHRReporting line of recordHR to Okta to appsDaily
Department and job codeHRDrives access rulesHR to OktaDaily
Work emailOkta or mail systemCreated by ITOkta to appsAt creation
Mobile phoneOkta (self-service)Maintained by the personOkta to appsHours
Start and end datesHRDrive lifecycleHR to OktaDaily or faster
Employment statusHRTriggers deactivationHR to OktaQuick
Sales region (custom)CRM applicationOnly CRM knowsCRM to OktaDaily

Keep this table in a place the whole team can read. Review it with HR, directory owners and application owners before any configuration begins.

Analogy

A building directory lists which office handles which service. When someone asks who deals with permits, nobody argues. They read the board.

12Choosing a Master: Five Questions

For each attribute, ask the same five questions in the same order.

1

Who creates the fact?

The system or team where the fact first becomes true, such as HR for a hire date, is usually the right owner.

2

Who has the legal or business duty to keep it right?

Duty brings accountability and correction processes.

3

How fresh can it be?

A source that updates once a month cannot master a fact that changes daily.

4

How reliable is it?

Look at error rates, missing values and how often corrections are needed.

5

Can Okta connect to it well?

Good connection matters, but only after the first four. Convenience alone is a poor reason.

Analogy

When choosing who should keep the family calendar, you ask who knows the plans, who cares if it is wrong and who will actually update it. Picking the person with the nicest handwriting is a bad rule.

13Priority Ordering When Several Sources Supply a Fact

Sometimes two systems legitimately know the same thing. A priority order says whose answer is used first.

Imagine a work phone number. HR may hold an old one, the corporate directory a newer one, and the person may have typed their own in Okta. If all three feed Okta, a ranking is needed. Okta lets you rank sources for an attribute, so that the highest-ranked source with a usable value wins. The exact options and screens depend on your product and edition, so confirm them in current documentation.

RankSourceUsed when
1Person via self-serviceThe person has entered a value
2Corporate directoryNo self-service value exists
3HR systemNeither above has a value

Rules for Good Ordering

  • Rank by knowledge, not by arrival. The last arrival should never decide.
  • Keep orders short. Two or three levels are easy to explain, and six are not.
  • Document each order and its reason. Future colleagues will ask.
  • Test with conflicting values. Put different values in each source and watch which one wins.
Analogy

A judge hears several witnesses and weighs those who saw the event over those who heard about it. A fixed order of trust makes decisions repeatable.

14Empty Values: Does Silence Overwrite the Truth?

What should happen when the master sends nothing for a field? The answer matters more than most teams expect.

SituationOption A: blank overwritesOption B: blank is ignored
Person’s phone was removed on purpose in HRCorrect; Okta clears itWrong; the old number stays
HR export dropped a column by accidentDisaster; thousands of fields clearedSafe; nothing changes
Manager field empty for a new executiveCorrectMay keep an old manager

Guidance

  • Protect critical fields from accidental blanks. Manager, department and status should not be wiped by a faulty file.
  • Add a safety cap. If a single import would clear more than a small share of values, stop and alert.
  • Separate “unknown” from “none.” Where possible, ask the source to send an explicit empty marker for fields that are truly empty.
  • Test your import with a deliberately incomplete file in a safe environment.
Analogy

If a clerk hands you an empty envelope, you do not throw away the letter you already had. You ask if the envelope is empty by mistake.

15Self-Service Attributes: Letting People Fix Their Own Data

Some facts are best kept by the person they describe. Others should never be editable by them.

Usually safe

Preferred name and pronouns

Personal, and best chosen by the person.

Usually safe

Mobile phone and photo

The person knows them first. Validate format.

Review

Work location

May affect access or tax rules. Allow requests, not direct edits.

Do not allow

Manager, department, job code, status

These drive access. Editing them is a path to privilege.

  • Decide, attribute by attribute, who may edit: the person, a manager, HR or nobody.
  • Keep the editing page simple and in the person’s language.
  • Make sure a self-service edit is not overwritten the next night by an import. Use priority or direction rules.
  • Log every edit by the person for audit.

Okta lets you control which attributes a user may view and edit. Names of the settings and the available levels depend on edition, so confirm them.

Analogy

Staff may update their own emergency contact on a form, but they cannot change their own salary band. The form shows only the boxes that suit the person.

16Designing Custom Attributes

Sooner or later the base profile is not enough. Custom attributes help, and they are easy to overuse.

Before Adding One, Ask

  • Does an existing attribute already hold this? Do not create a second “office” field.
  • Who owns it? Name the master before the field exists.
  • Who uses it? A field nobody reads is clutter and risk.
  • What type and range? A fixed list is safer than free text for anything that drives access.
  • Is it sensitive? Personal data needs special care and fewer readers.
  • What happens when it is blank? Rules built on it must cope.
Weak designBetter design
“location” as free textSite code from a controlled list
Two fields, “dept” and “department”One field, one master, one meaning
Yes/no values stored as text such as “Y”, “yes” and “true”A true boolean type
Field holding several facts separated by commasSeparate fields or a list type
Analogy

A form with an open box for “anything else” gets answers in every shape. A form with clear choices gets answers that can be counted.

17Normalizing Data Between Systems

Two systems can both be right and still disagree on how they write the same thing.

FactSystem A writesSystem B writesFix
CountryIndiaINChoose one standard and transform the other
Phone9876543210+91 98765 43210Store in one international format
Date03/04/20262026-04-03Use an unambiguous format
DepartmentFinance & AccountsFIN-ACCUse codes and a translation table
StatusActive1Map to one agreed list
  • Decide the standard form for every attribute in the ownership map.
  • Transform at the edge: change values as they enter Okta, so everything inside is consistent.
  • Keep the translation tables under version control, with an owner.
  • Watch for hidden issues: extra spaces, upper and lower case, and special characters.

Okta supports expressions to transform values in mappings. What functions exist and how they behave should be confirmed in current documentation.

Analogy

Travelers exchange money at the border so that prices make sense. Doing the exchange once, at the door, is easier than converting every price inside the shop.

18Names: The Hardest Simple Attribute

Names look easy and cause more trouble than any other field.

  • Legal name versus used name. HR holds the legal name. Many people use another name every day. Keep both, and decide which one appears where.
  • Name changes. Marriage, correction or transition changes names. Systems that use names as keys will break.
  • Different structures. Not everyone has a first and last name. Some have one name, some several family names.
  • Special characters. Accents and non-Latin scripts must survive every system between source and screen.
  • Length. Some applications cut names that are too long.
  • Display versus technical use. The display name is for people. The username and email are for systems and should not change casually.
UseWhich nameNotes
Payroll and legal lettersLegal name from HRMaster in HR
Directory and chatPreferred nameMaster in Okta self-service
Email addressFixed at creation by ruleAlias added on change; do not break old mail
Sign-in nameStable valueDo not make it depend on display name
Analogy

A passport shows the legal name, a nameplate on the desk shows the name colleagues use. Neither is wrong, and each has its place.

19Manager and Hierarchy Data

The manager attribute drives approvals, reviews and escalation. It is a favorite place for silent errors.

  • Master in HR. The reporting line of record belongs to the system that pays people.
  • Use a stable reference. Store the manager by employee number or ID, then display the name. Names change.
  • Handle gaps. Who approves for a person with no manager, or for a manager who has left? Define a fallback.
  • Watch loops. A reports to B and B reports to A will confuse approval chains.
  • Expect timing gaps. A manager change effective next month should not apply today.
  • Check for dangling references. A manager who left and was removed leaves orphans.
12,000
Illustrative employees at Alderbrook
1 in 40
Illustrative share of people changing manager in a year
300
Records needing a new manager each year if so
Analogy

A family tree with a missing parent leaves a branch hanging in the air. Everyone below it cannot find their way up.

20Employment Status and Lifecycle Triggers

The status attribute is the most powerful field in the profile. It decides whether a person can sign in at all.

HR statusOkta actionCaution
Pre-hire (accepted offer)Create profile, keep inactive until startDo not grant access early
ActiveActivate, provision accessCheck start date
On leaveSuspend or limit, by policyRules differ by country and leave type
TerminatedDeactivate, remove access quicklyTiming is a security matter
RehiredReactivate the same profile, if rules allowDo not inherit old access blindly
  • Make HR the master of status and dates.
  • Define how quickly a termination must reach Okta, and measure it.
  • Protect against false terminations: a broken file marking everyone inactive must not lock out the company. Use the safety cap again.
  • Keep a manual emergency route for urgent removals that cannot wait for HR.
Analogy

The hospital door badge system should stop working on the day a person leaves, and not a month later. It should also not stop for the whole ward because of a typing slip.

21Contractors, Interns and Other Non-Employees

Not everyone comes from the HR system. External workers need a master too, or they become the hole in the fence.

Worker typeLikely masterKey concerns
EmployeeHR systemStandard lifecycle
Contractor via agencyContractor management or procurement systemContract end date drives expiry
InternHR or campus systemFixed term; clear end date
Partner staffSponsor-managed listNamed sponsor; regular reconfirmation
VolunteerLocal coordinatorLimited access; regular check
  • Give every external profile a named sponsor who is accountable.
  • Require an end date, and make expiry the default.
  • Mark worker type clearly in the profile, so rules can treat types differently.
  • Do not store contractors in a loose spreadsheet that nobody owns.
Analogy

Visitors to an office sign in at the front desk with a host and a time. A guest who walks in through the loading bay with no name has not been counted.

22Rehires, Name Reuse and Returning People

People leave and come back. Systems that assume a person only joins once will misbehave.

  • Reuse or create new? Decide whether a returning person gets their old profile back or a fresh one. Reusing keeps history, and a fresh one keeps access clean.
  • Reset access on return. Do not restore the previous groups automatically. The new job may differ.
  • Identifiers. Keep the same employee number if HR does, or document the mapping.
  • Email and username. Decide how to handle a name that is already in use by someone else.
  • History and audit. Keep the earlier record accessible to auditors.
  • Different roles. A former contractor who becomes an employee changes worker type and master.
Analogy

A returning student receives the same student number but is placed in new classes. The old timetable does not apply.

23Future-Dated and Time-Based Changes

Many real changes are planned: a transfer next month, a promotion on the first of the quarter, a resignation with a notice period.

  • Know what your HR source sends. Some send the future value early, and some send it only on the effective date.
  • Avoid early effects. A promotion effective next month should not grant new access today.
  • Avoid late effects. A transfer should not leave access to the old team for weeks.
  • Use effective-date fields. Keep the date next to the value, and let rules read it.
  • Schedule imports to match. Daily is usually enough for planned changes, but terminations may need faster handling.
  • Test boundary days. First of month, end of year and time zone differences expose errors.

Whether Okta can act on future-dated values directly, or needs help from workflows or rules, depends on your product and edition. Confirm the options.

Analogy

A train timetable that changes on a set day must show the new times from the first morning. Printing them a week early confuses commuters, and a week late strands them.

24Handling Exceptions and Special People

Every organization has people who do not fit the rules: executives with private records, staff on secondment, employees with two roles, or people whose data must be hidden for safety.

CaseChallengeApproach
Secondment to another entityTwo managers, two departmentsChoose the primary record and note the second role in a controlled field
Executives and sensitive rolesRecords may be hidden in HRAgree a special feed or manual profile with extra approval
Shared or role accountsNo single person to masterTreat as a non-person account with a named owner
Staff protected for safetyName and location must stay privateLimit visibility and mapping, and document who may see them
Part-time at two sitesWhich site drives accessUse a primary site plus an approved extra site list
  • Write the exception rules down. Hidden exceptions become hidden risks.
  • Give every exception an owner, a reason and a review date.
  • Keep the number of exceptions small. If they keep growing, the rule needs redesign.
  • Report exceptions to auditors openly.
Analogy

A school timetable works for nearly everyone, and the few pupils who attend two schools get a written arrangement. A note on the office wall beats a memory in one teacher’s head.

25Conflicts Between Sources

Even with good rules, sources will disagree. The question is whether the disagreement is seen and handled.

ConflictExampleHandling
Value differsHR says “Nurse Manager”, directory says “Charge Nurse”Master wins; report the difference to the owner of the other source
Same record, two keysEmployee number matches one profile, email anotherHold for review; never merge automatically
Status disagreementHR says terminated, application says activeHR wins; deactivate and alert
Race between updatesSelf-service edit and nightly import arrive togetherPriority order decides; log the winner
Source outageHR feed late for two daysKeep last known values; alert; do not blank

Treat every conflict as information. A recurring disagreement shows that a system is wrong, a rule is unclear or a process step is missing. Send a short weekly report of conflicts to the owner of each source so the cause gets fixed rather than hidden.

Analogy

When two clocks in a station disagree, the stationmaster does not average them. They look at which one is connected to the official time signal and repair the other.

26Attribute Mappings: The Wiring Between Profiles

Mappings are the pipes through which values travel. A badly laid pipe leaks quietly for months.

Each application connected to Okta has its own user profile and a mapping that links its fields to the Okta profile. A mapping has a direction and, sometimes, a transformation. For most fields the direction is from Okta to the application. For fields the application masters, it is the other way round.

Mapping Habits

  • One direction per field. Review every mapping for accidental two-way flows.
  • Map only what the application needs. Extra fields spread personal data and create more places to be wrong.
  • Name transformations. A short note beside each, saying what it does and why.
  • Treat the mapping as code. Keep a record of changes, review them and test them before release.
  • Check data types. Text sent into a number field fails silently in some applications.
  • Plan for missing values. Decide what the application receives when a field is empty.
Analogy

Plumbers label pipes for hot, cold and waste. A building with unlabeled pipes works until the day someone connects the wrong two.

27HR Systems as the Source for Workers

For most companies, the HR system is the natural master of the worker lifecycle. Setting that up well pays back every day.

flowchart LR
    HR["HR system of record"] -->|"Hires, changes, terminations"| OK["Okta import"]
    OK --> UD["Okta profile"]
    UD --> GR["Group rules from department and location"]
    UD --> PR["Provisioning to applications"]
    UD --> DEP["Deactivation on termination"]
    UD -.->|"Optional write-back of email"| HR
    
Figure 4. HR is the master of the person. Okta uses its facts to drive groups, provisioning and removal.
  • Agree the feed. Which fields, how often, in what format, and who fixes a failed run.
  • Pick the identifier. Employee number is the usual choice.
  • Plan pre-hire. Decide when a profile is created and when it becomes active.
  • Plan write-back. Often the work email created by IT is sent back to HR. Agree which attributes go back, and keep them few.
  • Plan for exceptions. Executives, VIPs and sensitive roles may need special handling.

Okta provides integrations for many HR systems, and the exact fields, schedules and options differ by system and edition. Confirm what your HR integration supports before designing around it.

Analogy

The staff register at a school is the base for class lists, canteen cards and library accounts. When a pupil enrolls or leaves, the register changes first, and the rest follow.

28Corporate Directories as Sources

Many companies still run an on-premises directory. It often owns sign-in details and group membership, while HR owns the business facts.

Attribute kindLikely masterReason
Sign-in name, local account stateDirectoryIt runs the local logon
Group membership for local serversDirectoryServers read it directly
Job title, department, managerHR, pushed into directory if neededHR knows first; directory is a consumer
Work emailMail system or OktaCreated by IT
  • Avoid circular flows. HR to Okta to directory and also directory to Okta for the same field creates a loop.
  • Be careful with sync scope. Import only the groups and organizational units you need.
  • Plan the cleanup. Old directories hold years of stale titles and phone numbers. Importing them blindly imports the mess.
  • Watch deletions. What happens in Okta when an object is deleted or moved in the directory?
Analogy

An old filing cabinet in the basement may hold useful records and a great deal of clutter. Moving it to a new office without sorting only moves the clutter.

29Writing Data Back to Sources

Sometimes Okta creates a fact that another system needs, such as a new email address. Sending it back must be careful, or it creates loops.

  • Keep write-backs small. Write only the few fields the source does not own, such as email or username.
  • Never write back a field the source masters. It invites a fight between systems.
  • Use a service account with narrow rights. It can edit only the intended fields.
  • Log each write. Support will ask when and why a value appeared.
  • Test for loops. Change a field in a safe environment and watch for repeated updates.
  • Agree ownership with the source team. They must accept the writes.
Analogy

A new tenant tells the post office their new address. The post office does not then tell the tenant to move. Information flows in one direction for each fact.

30Applications as Profile Sources

Some applications know things nobody else does. Letting them master those facts is sensible, within limits.

ReasonableRisky
CRM masters sales region and territoryCRM masters job title that HR also holds
Learning system masters certification statusLearning system masters employment status
Clinical scheduling masters clinic assignmentLocal app lets managers edit department by hand
Badge system masters site access zoneBadge system masters name or manager
  • Limit scope. An application may master only the attributes unique to its domain.
  • Record the reason. Why this application, why this field.
  • Prevent shadow masters. If local administrators can edit a field in the app, it is not truly mastered elsewhere.
  • Check the import cost. Frequent imports from large apps can be slow or hit limits.

Which applications can act as a profile source in Okta, and how, depends on the integration and edition. Confirm in current documentation.

Analogy

The kitchen knows today’s allergy notes better than the head office. Letting the kitchen own that note is wise. Letting it also change the guest’s name is not.

31Profile Data That Drives Access

Many access rules read the profile. Whoever controls those attributes controls the access.

Okta can create group memberships from rules that read attributes such as department, location or worker type. The group then grants application access. This is powerful and convenient, and it makes the attribute master a security decision.

RuleAttribute it readsRisk if the attribute is wrong or editable
Finance group from departmentDepartmentAnyone changed to Finance gets payroll access
Clinic staff group from site codeSite codeWrong site exposes patient data
Contractor restrictions from worker typeWorker typeA contractor labeled employee gets employee access
Manager tools from manager flagIs managerFalse flag grants approval powers

Safeguards

  • Make the master of access-driving attributes a controlled, audited system, not a self-service field.
  • Preview the effect of a rule change before saving.
  • Alert when large groups change suddenly.
  • Review rules with application owners every year.
Analogy

If a door opens for anyone wearing a green badge, then whoever prints the badges holds the real power. Protect the printer.

32Customer and Consumer Profiles

Profile mastering also applies to customers, patients and partners, where the person owns their own data and the rules differ.

  • The person is often the master. Customers maintain their own details, so self-service plays a larger role.
  • Consent matters. Record what the person agreed to, when, and for which purpose, and make it easy to change.
  • Identity may arrive from elsewhere. Social or partner sign-in supplies some attributes. Decide how far to trust each one.
  • Volume is larger. Millions of profiles need careful limits, batching and monitoring.
  • Verification differs. Verified and unverified emails or phone numbers should be marked, and rules should treat them differently.
  • Deletion requests are real. Know every place a profile lives so that erasing it is possible.

General guidance only: privacy and consent rules differ by country and industry, so ask your privacy and legal teams what applies to you. Okta offers separate products and settings for customer identity, and their features vary, so confirm in current documentation.

Analogy

A shop keeps a customer’s address to deliver parcels. If the customer moves and says so, the shop updates its card rather than arguing with the postman.

33Mergers and a Second HR System

When two companies join, so do two answers to every question about a person.

  • Do not merge masters overnight. Run both HR systems as masters for their own populations first.
  • Mark origin on each profile. A field such as company or legal entity lets rules treat each group correctly.
  • Prevent key collisions. Two companies may both have an employee number 10234. Prefix or scope the keys.
  • Plan the target. Decide the final single master and a date, then migrate in waves.
  • Reconcile duplicates. People who work for both entities need one profile, not two.
  • Keep reporting working. Managers across the old boundary still need approvals.

Some designs use several Okta orgs during a merger, and others add the second population to the same org. Each has trade-offs for sharing, separation and cost. Confirm the options for your edition.

Analogy

Two schools merging keep both class lists until the new timetable is ready. Throwing the lists together on the first day puts two children with the same roll number in one seat.

34Import Schedules, Triggers and Latency

The rules decide who wins. The schedule decides how soon.

Kind of changeAcceptable delayApproach
TerminationMinutes to an hourFrequent or event-based import; manual emergency route
New hireHours, ahead of start dateDaily import with early profile creation
Manager or department changeA dayDaily import
Title or phoneA day or moreDaily or weekly
Self-service editsImmediateApplied in Okta directly, then pushed
  • Write the acceptable delay for each class of change in the ownership map.
  • Measure the real delay. Compare change time in the source with the time in Okta and in the target application.
  • Watch overlapping runs. A slow import that is still running when the next starts can cause odd results.
  • Know your limits. Large imports and pushes are subject to rate limits that depend on your org.
Analogy

Newspapers print daily, while a fire alarm must ring at once. Each kind of message gets the speed that fits the harm of waiting.

35Data Quality as a Continuing Program

Mastering rules move data well. They cannot make wrong data right. Quality needs its own routine.

CheckExampleAction
CompletenessProfiles missing a managerSend list to HR for correction
ValidityPhone numbers with lettersReject or fix at the source
UniquenessTwo profiles with one employee numberInvestigate and merge or retire
ConsistencyDepartment not on the approved listCorrect or add to the list
TimelinessTerminated people still activeDeactivate; find why the feed was late
AccuracyManager who left the companyAssign a new manager

Run these checks every week, publish a short scorecard and send each source owner the exceptions that belong to them. Fixing the cause at the source is better than fixing the symptom in Okta every month.

Analogy

A gardener who keeps pulling the same weed without finding the seeds will pull it all summer. Following the weed to its source ends the work.

36Testing Mastering Rules Before Production

A change to a mastering rule can touch thousands of profiles at once. It deserves more testing than most changes.

1

Use a safe copy

A preview or test org with realistic but fake data, and the same settings as production.

2

Build test people

Create profiles that cover each case: new hire, transfer, leaver, rehire, contractor, name change, missing manager.

3

Create conflicts on purpose

Put different values in each source and verify which one wins.

4

Test empty and broken inputs

Missing columns, blank values, odd characters and late files.

5

Check the downstream effect

Confirm groups, provisioning and application profiles look right.

6

Record results

Keep the test evidence with the change record.

Analogy

Before a school changes its bell schedule, it tries it on a Wednesday with one class. The mistakes found there cost minutes, while the same mistakes found school-wide cost a day.

37Changing a Master Safely

Sooner or later you will move a master from one system to another. Done carelessly, this overwrites good data with bad.

1

Snapshot everything

Export current profiles and settings, so you can compare and restore.

2

Compare old and new masters

Run both in read-only mode and list differences per attribute.

3

Fix the gaps at the new source

Correct data before it takes over.

4

Switch a small group first

One department or site, then watch for surprises.

5

Widen in waves

Expand only when the differences report is clean.

6

Retire the old path

Remove old imports and mappings so nobody can turn the old master back on by mistake.

Analogy

Moving house works best when you carry the boxes over in several trips, check them against a list and keep the old keys until the last trip is done.

38Retiring Attributes, Sources and Mappings

Old fields and old feeds linger long after their purpose has gone. Each one is a place for wrong data and hidden risk.

  • Find unused attributes. Check which rules, mappings and applications still read them.
  • Announce before removing. Give owners time to object.
  • Stop writing first. Switch off imports and pushes, watch for errors, then remove the field.
  • Clean the data. Personal data in unused fields should not remain without reason.
  • Remove old credentials. Retired feeds should lose their service accounts and secrets.
  • Update the map. The ownership map should always match reality.
  • Record the retirement. Date, reason and approver, for audit.
Analogy

When a shop closes a department, it removes the sign, empties the shelves and cancels the supplier. Leaving the empty aisle with its lights on invites trouble.

39Rollback and Recovery of Profile Data

Mistakes will happen. The question is how quickly you can undo them.

  • Keep regular exports. A recent copy of profile data and mapping settings is the base of any recovery.
  • Record who changed what. The System Log and change records show the moment things went wrong.
  • Know your restore path. Restoring values from an export needs a tested procedure, not a guess at midnight.
  • Be careful of side effects. Restoring a status can trigger provisioning emails or reactivate accounts.
  • Pause before repairing. Turn off the faulty import first. Otherwise it overwrites the repair.
  • Tell people. Support, HR and application owners need to know what was affected.
!
Warning

Always stop the cause before repairing the effect. A repaired value that is overwritten again an hour later teaches the team the wrong lesson.

Analogy

When a pipe bursts, you turn off the water before mopping the floor. Mopping first only keeps you busy.

40Profile Data and Zero Trust

Zero trust means no access is trusted only because it was granted once. Profile data gives each decision its facts, so the facts must be trustworthy.

Every zero trust decision asks who the person is, what they are doing and whether it fits. The answers come from the profile: department, location, worker type, manager and status. If these fields are stale or editable by the wrong people, the decision rests on sand.

  • Treat profile attributes as security inputs. Each one that feeds a policy needs an owner, a master and a freshness target.
  • Prefer facts from authoritative masters. HR status beats a manually typed field.
  • Re-check on change. When a transfer happens, access should be re-evaluated, not left alone.
  • Watch for drift. An attribute that nobody reviews can quietly become wrong.
  • Log decisions with the attributes used. Later you can explain why access was given.

Which attributes your Okta policies can read, and how quickly changes take effect, depends on your edition, so confirm them in current documentation.

Analogy

A border guard checks the passport, but also trusts that the passport office issued it correctly. Poor records at the office make every check at the border weaker.

41Ownership and Governance of Profile Data

Every attribute needs a human owner. Without one, rules drift and errors stay.

RoleResponsibility
Identity data ownerKeeps the ownership map, approves changes to masters and priorities
HR data stewardFixes errors in the HR source and explains HR rules
Directory ownerMaintains the directory and its sync
Application ownersConfirm what each application needs and masters
SecurityReviews attributes that drive access
Privacy officerReviews personal data collected and shared
Support leadReports patterns from tickets
  • Name one accountable owner and one deputy for the ownership map.
  • Keep a change record: who asked, who approved, what changed, when.
  • Meet quarterly to review conflicts, quality scores and requests waiting.
  • Require an owner and reason before any new attribute or master is created.
Analogy

A town keeps a land registry with a clerk who answers for each entry. The registry works not because maps are clever, but because someone is accountable for them.

42Securing the Profile Pipeline

If an attacker can change profile data, they can change who gets access. The pipeline is a target.

Where Attacks Can Land

  • The source system. A compromised HR or directory account can rewrite departments and managers.
  • The connection. Credentials for imports and writes are powerful secrets.
  • Okta administration. An administrator who can edit mappings and priorities can redirect access.
  • Self-service pages. Weak controls on editable attributes let people grant themselves privileges.
  • Files in transit. HR feeds sent as files can be intercepted or altered.

Defenses

  • Limit who can change mastering settings, and require review of every change.
  • Use dedicated service accounts with narrow rights, and rotate their secrets.
  • Protect feeds with encryption and integrity checks.
  • Alert on unusual changes: many managers changed at once, or mass status changes.
  • Keep access-driving attributes out of self-service.
  • Log and review administrator actions on profile settings.
Analogy

The person who prints the guest list controls the party. Guarding the printer, the paper and the door guard’s copy matter as much as guarding the door.

43Privacy and Minimization in Profiles

A profile is personal data. The more fields you hold and share, the more you must protect.

!
General orientation only

This chapter is general guidance, not legal advice. Privacy law differs by country and industry, so ask your privacy and legal teams what applies to you.

  • Store the minimum. Every attribute needs a reason, an owner and a user.
  • Share the minimum. Map only the fields each application needs.
  • Separate sensitive fields. Home address, date of birth and national identifiers should be rare in Okta and limited to few readers, if present at all.
  • Limit who can read. Administrators and support see only what their job needs.
  • Respect corrections and deletions. When someone asks to fix or erase data, you must know every place it lives.
  • Set retention. Decide how long inactive profiles and logs are kept, and what happens at the end.
  • Be open. Tell people what you hold and why.
Analogy

A clinic asks for the details needed for treatment and keeps them locked. Collecting everything “just in case” creates a bigger safe to guard and more to lose.

44Supporting the People Who Own the Data

Data stewards in HR, directory and application teams hold the real power to keep profiles right. They need help, not only requests.

  • Give them a simple view. A weekly list of the exceptions that belong to them, with the person, field and value.
  • Explain why it matters. A wrong manager means approvals go astray. A late termination means leftover access.
  • Make correction easy. Provide a short route to fix data at the source, not a long form to Okta administrators.
  • Close the loop. Show them the improvement after they act.
  • Name a deputy. Holidays should not stall corrections.
  • Say thank you. Stewardship is quiet work that rarely gets noticed until it fails.

When Stewards Struggle

If one team receives thousands of exceptions a week, the process is broken upstream, perhaps in how data is first entered. Look for the cause, such as a form with free-text fields, and fix the input rather than asking for endless corrections.

Analogy

A school secretary who gets a tidy list of pupils with missing forms can chase them in an hour. One who gets a pile of mixed papers will spend the week sorting.

45Monitoring, Logging and Metrics

You cannot manage what you cannot see. A few measures show the health of the mastering arrangement.

MeasureWhat it tells youHealthy sign
Import success and durationWhether feeds run on timeSteady and completes within the window
Records changed per importUnusual swingsStays near normal range
Conflicts detectedDisagreeing sourcesLow and falling
Profiles missing key attributesCompletenessNear zero
Time from HR change to applicationEnd-to-end delayWithin target for each change type
Push errorsBroken mappings or applicationsRare and fixed quickly
Manual overridesHidden workaroundsRare and justified

Okta’s System Log records import, update and push events, and you can stream it to your monitoring platform. Event names and streaming options change, so confirm them in current documentation. Build a dashboard that the owner looks at weekly.

Analogy

A pilot watches altitude, speed and fuel, not a thousand dials. A small, well-chosen set of gauges tells you whether the flight is healthy.

46Alerts and Incident Response

When profile data goes wrong, the effects spread fast. Quick alerts and a rehearsed response limit the damage.

Alerts Worth Having

  • An import that did not run, or ran far longer than usual.
  • A single import that would change more than a small share of profiles.
  • Mass changes to status, manager or department.
  • Rising push errors to a key application.
  • A change to mastering or priority settings.

When Data Goes Wrong

1

Stop the source

Pause the import or push that is causing damage.

2

Measure the damage

List affected profiles and what each application received.

3

Protect access

If access was wrongly granted or removed, handle urgent cases by hand first.

4

Repair

Restore from the latest good snapshot, then resume imports under watch.

5

Review

Write down cause, effect and the new check that would have caught it.

Analogy

A good ward has a routine for a patient who suddenly worsens: call for help, stabilise, find the cause, treat, then record what was learned.

47Failure Scenarios and Recovery

Thinking about failures in advance turns panic into procedure.

flowchart TD
    A["Profile data looks wrong"] --> B{"Did an import run recently?"}
    B -->|"No"| C["Check the schedule and source availability"]
    B -->|"Yes"| D{"Did many profiles change at once?"}
    D -->|"Yes"| E["Pause import and compare with the last snapshot"]
    D -->|"No"| F{"Does one person's value differ across sources?"}
    F -->|"Yes"| G["Check priority order and which source won"]
    F -->|"No"| H{"Is the application showing a different value?"}
    H -->|"Yes"| I["Check the mapping and push errors"]
    H -->|"No"| J["Escalate with logs and examples"]
    
Figure 5. A short decision tree for the first minutes of a profile data problem.
ScenarioEffectPreparation
HR feed arrives emptyFields blanked or everyone marked inactiveSafety caps; refuse empty files
HR feed arrives lateDelayed hires and terminationsMonitoring; manual route for urgent cases
Directory sync stopsLocal accounts drift from OktaAlert on last successful sync
Two-way loop between systemsValues flip repeatedlyOne direction per field; test for loops
Wrong priority changeStale source overwrites better dataReview, preview and snapshot before changes
Application rejects updatesApplication profiles lagPush error alerts; retry plan
Analogy

Hospitals test their backup generators monthly. Nobody hopes to need them, and everyone is glad they are tested on the night the power fails.

48Performance, Scale and Limits

Mastering works easily for hundreds of people. At tens of thousands, size and speed matter.

  • Import in sensible batches. Large full imports are slower than changes only. Prefer incremental updates where the source supports them.
  • Mind rate limits. Okta limits request rates, and applications have their own. Heavy pushes can queue or fail. Ask about limits for your org and plan large changes for quiet times.
  • Limit unneeded mappings. Each mapped field is another update to send.
  • Avoid cascading changes. A department rename can change thousands of group rules at once.
  • Stage big events. Annual reorganizations and mass transfers should be rolled out in waves.
  • Watch the slowest step. Often it is a legacy application, not Okta.
12,000
Illustrative profiles at Alderbrook
40
Illustrative mapped attributes per application
480,000
Field values to move if a full re-push touches every attribute for one application
Analogy

Moving a few chairs is quick. Moving the whole furniture store needs a plan, a schedule and enough lorries.

49Audit Evidence and Compliance

Auditors ask how you know who a person is, what they hold and why. Profile data is the base of those answers.

!
General orientation only

Compliance requirements depend on your industry and region. Treat this chapter as a starting point and confirm specifics with your compliance team.

Auditor questionEvidence to keep
Which system is the source of truth for each attribute?The ownership map, with dates and approvers
How quickly are leavers removed?Time measures from HR change to deactivation
Who can change mastering settings?Role lists and change approvals
What changed and when?Change records and System Log exports
Is data accurate?Quality scorecards and correction records
Is personal data minimized?Attribute inventory with reasons and owners
Can you recover from errors?Snapshots, restore tests, incident reports

Collect this evidence as a habit, not in a panic. Save one export or screenshot per control each quarter, with a date and a name.

Analogy

A restaurant shows its inspection certificate on the wall because it kept records all year. Cleaning the kitchen the night before the inspector arrives impresses nobody who knows what to look for.

50Measuring the Value of a Mastering Strategy

Leaders fund what they can see. A few simple measures show whether the work is paying off.

MeasureWhat it showsHealthy direction
Time from HR termination to account removalSecurity exposureFalling to the target
Time from hire to full accessOnboarding speedFalling
Profiles with missing or invalid key attributesData qualityFalling toward zero
Conflicts detected per weekDisagreeing sourcesFalling
Tickets about wrong profile dataUser painFalling
Approval requests sent to a wrong or absent approverManager data qualityNear zero
Attributes without an ownerGovernance gapsZero

Report once a quarter on one page, with a short story, such as the clinic that onboarded forty new nurses in a day. Numbers persuade the head, and stories persuade the heart.

Analogy

A gardener checks soil, growth and weeds each season. If nobody looks, the garden seems fine from the path while the roots are failing.

51Advantages, Disadvantages and Trade-offs

A deliberate mastering strategy brings clarity and takes effort. Seeing both sides helps you choose how far to go.

What a clear strategy buys

  • One answer to “what is true?” for each attribute
  • Faster and safer onboarding and offboarding
  • Approvals reaching the right people
  • Cleaner audits and fewer disputes
  • Easier changes during mergers and reorganizations

What it costs

  • Up-front work to agree ownership across teams
  • Ongoing data quality effort at the sources
  • More configuration to test and document
  • Dependence on source systems’ reliability
  • Some loss of local freedom to edit data
Trade-offLeaning toward flexibilityLeaning toward control
Self-service attributesMany editable fieldsFew, mostly personal
Number of mastersMany, per applicationFew, central
Import frequencyFrequent, more loadDaily, more delay
Blank handlingBlanks overwriteBlanks ignored with alerts
Analogy

A tidy kitchen where every tool has a place takes effort to set up and keep. It saves time at every meal after that.

52Design Patterns and Anti-Patterns

Teams keep rediscovering the same good and bad habits. Naming them helps you follow the first and avoid the second.

PATTERN: HR owns the person Recommended
What it looks like

The HR system masters identity, employment status, job data, manager and dates. Okta consumes them and drives groups and provisioning.

Why it works

The system that pays people is also the one with the strongest duty to keep their records correct.

PATTERN: People own their contact details Recommended
What it looks like

Preferred name, mobile phone and photo are edited by the person in Okta and pushed outward. Imports do not overwrite them.

Why it works

The person knows these facts first, and corrections need no ticket.

PATTERN: Safety caps on every import Recommended
What it looks like

Imports stop and alert if they would blank many fields, deactivate many people or change more profiles than expected.

Why it works

A faulty feed becomes an alert and not an outage.

ANTI-PATTERN: Last writer wins Frequent
What it looks like

Several sources write the same field with no priority. Whoever ran last decides.

Why it hurts

Values flip overnight, nobody can explain them, and access rules misfire.

ANTI-PATTERN: Two-way sync on one field Frequent
What it looks like

A field is imported from an application and also pushed to it.

Why it hurts

Loops, delays and baffling history in the logs.

ANTI-PATTERN: Editable access-driving fields Dangerous
What it looks like

Department or worker type can be changed by the person or a local administrator.

Why it hurts

People can change their own access by editing a field.

Analogy

Recipes passed down in a family are sorted into those that work and those that burned the kitchen. Writing both lists down saves the next cook from the burns.

53Common Myths About Profile Mastering

Some beliefs sound sensible and lead to poor decisions.

MythReality
The most connected system should be the master.Master the system that knows best, then connect it.
Okta should be the master of everything.Okta is a hub. HR still knows employment facts first.
Two-way sync keeps everything consistent.Two-way sync on one field creates loops and ambiguity.
The newest value is the right one.Newest may simply be the last accident. Rank by authority.
Blank means no change.Blank may mean cleared on purpose, or a broken feed. Decide and test.
Data cleanup is a one-time project.Data decays daily. Quality needs a routine.
Self-service reduces security.Self-service for safe fields reduces tickets. Only access-driving fields must stay controlled.
Once configured, mastering is finished.Mergers, new tools and reorganizations keep changing the right answer.
Analogy

Sailors’ sayings about the weather are partly true and partly dangerous. A wise captain also reads the barometer.

54Reviewing Attributes and Masters Once a Year

The right master today may not be the right master in two years. A short yearly review keeps the map honest.

1

List attributes and readers

For each attribute, list the rules, mappings and applications that still read it.

2

Re-ask the five questions

Who creates it, who owes accuracy, how fresh, how reliable, how well connected? Systems and teams change.

3

Check the quality numbers

A master with a rising error rate may need help, or replacing.

4

Look for new needs

New applications, new regulations or a merger may create new attributes or new masters.

5

Update the map and tell people

Publish changes, record approvers and retire what is no longer needed.

Analogy

A yearly service checks the brakes, tyres and oil of a car that seems fine. The faults it finds are the ones that would otherwise appear on a motorway.

55Best Practices Checklist

A single page to run through before launch and every quarter after.

  • Every attribute in use has a named master and a written reason.
  • Each attribute flows in one direction only.
  • Priority orders are short, documented and tested with conflicting values.
  • Matching uses a stable, unique key that is never reused.
  • Blank values and missing files cannot wipe critical fields.
  • Safety caps stop mass changes and alert people.
  • Access-driving attributes are not self-service, and their masters are controlled.
  • Contractors and partners have a master, a sponsor and an end date.
  • Change timing is defined for each type of change, and measured.
  • Names, phone numbers and dates follow one standard format.
  • Mappings carry only the fields each application needs.
  • Changes to masters go through review, testing and staged rollout.
  • Snapshots exist and restores have been practiced.
  • Dashboards and alerts are in place and watched.
  • Owners, deputies and review dates are written down.
  • Evidence is saved every quarter.
Analogy

A pilot’s pre-flight list, a surgeon’s pre-operation list and a builder’s inspection list all exist because even experts forget. The list is not an insult, but a safety net.

56A Design Exercise: Alderbrook’s Mastering Strategy From Start to Finish

Let us solve the problem from the start of this guide, step by step.

1

Take stock of sources

List every system holding facts about people: the HR system, the staff directory, the clinic scheduling app, the badge printer system and the ticketing tool. Note who runs each one.

2

List attributes in use

Write down every field read by a group rule, an approval or a mapping. Cross out the ones nobody uses.

3

Assign masters

HR masters legal name, employee number, manager, department, job code, status and dates. Okta masters preferred name and mobile phone. The scheduling app masters clinic assignment. Email is created by IT and flows outward.

4

Set directions and priorities

One direction per field. Self-service wins for preferred name and phone. Everything else follows its single master.

5

Add safety

Safety caps on imports, refusal of empty files, alerts on mass changes and a manual route for urgent leavers.

6

Test with conflicting records

Priya’s name change, Dev’s transfer, a rehire and a contractor go through a safe copy of the setup.

7

Release in waves

One clinic first, then the region, then everyone, watching conflicts and delays.

8

Run it

Weekly quality scorecard, quarterly review of the ownership map and an annual test of restore steps.

flowchart LR
    HR["HR system: name, ID, manager, department, status, dates"] --> UD["Okta profile"]
    SCH["Scheduling app: clinic assignment"] --> UD
    SELF["Person: preferred name and mobile phone"] --> UD
    UD --> MAIL["Email and collaboration tools"]
    UD --> BADGE["Badge system"]
    UD --> TICKET["Ticketing and approvals"]
    UD --> GROUPS["Groups and access rules"]
    
Figure 6. Alderbrook’s target: three clear masters feed one profile, and every other system receives from it.

After the change, Priya’s new name is entered once in HR. By the next morning her profile, email display name, directory entry and badge print queue all agree. Dev’s transfer moves her time sheets to the right approver the same day, since the manager field follows a single source.

Analogy

Tidying a workshop starts with counting the tools, deciding where each belongs and labeling the shelves. It stays tidy only if someone keeps the labels honest.

57Real-World Scenarios and Worked Numbers

Numbers make the stakes visible. All figures here are illustrative and meant to show the thinking, not to predict your results.

Scenario 1: The Empty File

A change in the HR export dropped the manager column. The import treated blanks as real values and cleared the manager of all 12,000 profiles. Approval requests had no destination for a day. With a safety cap that stops an import if more than, say, two percent of managers would change at once, the import halts and sends an alert. Cleanup of 12,000 profiles becomes a ten-minute fix of one file.

Scenario 2: The Slow Leaver

Suppose 1,200 people leave each year and the average delay from HR change to account removal is three days. That is 3,600 person-days of unneeded access. Moving to a near-daily feed and a one-hour target cuts the exposure to about 50 person-days. The cost is a faster schedule and a little more monitoring.

12,000
Profiles blanked by an empty manager column
3,600
Person-days of leftover access a year at a three-day delay
50
Person-days a year at about a one-hour delay

Scenario 3: The Flip-Flop Title

A job title was imported from the scheduling app and pushed from HR. Every night it flipped. Support received thirty tickets a month asking why the title changed. Removing one direction ended the tickets and the nightly noise in the logs.

Analogy

A shopkeeper who counts the customers who walk out learns more than one who only counts sales. Silent losses are the expensive ones.

58A Maturity Path and a 90-Day Plan

You do not need to solve everything at once. A path of small, safe steps works better than one big promise.

LevelWhat it looks like
1. AccidentalSources write freely, last writer wins, nobody owns the rules
2. DocumentedAn ownership map exists and the biggest conflicts are fixed
3. ControlledSingle direction per field, priorities set, safety caps, tested changes
4. MeasuredQuality scorecards, timing measures, alerts, regular reviews
5. GovernedOwners, evidence, practiced recovery, planned handling of mergers

The First 90 Days

1

Days 1 to 20: Discover

List sources, attributes in use, current flows and known conflicts.

2

Days 21 to 45: Decide

Hold workshops with HR, directory and application owners. Publish the ownership map.

3

Days 46 to 70: Configure and test

Fix directions, priorities and safety caps in a test copy. Run conflict tests.

4

Days 71 to 90: Release and watch

Roll out in waves. Start the weekly scorecard and the quarterly review.

Analogy

Learning to cook starts with boiling water and ends with a feast. Nobody starts with the feast, and the early lessons prevent burns.

59A Troubleshooting Playbook

When someone says “this value is wrong,” a steady routine finds the cause faster than guessing.

SymptomLikely causeFirst check
A value reverts after being fixedAnother source or direction overwrites itFind all sources and mappings for that field
Okta and the application show different valuesPush failed or field is mastered by the applicationPush errors and mapping direction
New hire has no profileLate feed or failed matchImport log and matching key
Leaver still activeStatus not mastered in HR, or feed lateHR record, import time and rules
Wrong approver on requestsStale managerManager value, its source and last change
Two profiles for one personDifferent keys in different sourcesMatching rules and duplicate report
Group membership wrongRule reads a wrong attributePreview the rule against the profile
Odd characters in namesEncoding issue in a feedSource encoding and transformations

The Routine

  • Write the exact disagreement: person, attribute, system and values.
  • Find which source supplied each value and when.
  • Check which rule or priority applies.
  • Compare Okta with the application.
  • Repair the case, then the cause, then look for others with the same pattern.
Analogy

A good mechanic listens, checks fuel, then spark, then air. A repeatable routine finds the fault with less luck and less cost.

60A Quick Decision Guide: Who Should Master This Attribute?

When a new attribute is requested, ask the same short questions in the same order.

flowchart TD
    A["New attribute requested"] --> B{"Does an existing attribute already hold it?"}
    B -->|"Yes"| C["Reuse the existing attribute"]
    B -->|"No"| D{"Is it a fact about employment?"}
    D -->|"Yes"| E["HR is the master"]
    D -->|"No"| F{"Does the person know it best and is it safe to edit?"}
    F -->|"Yes"| G["Okta self-service is the master"]
    F -->|"No"| H{"Does one application alone know it?"}
    H -->|"Yes"| I["That application is the master, for this field only"]
    H -->|"No"| J["Escalate to the identity data owner"]
    
Figure 7. Each answer leads to one master. If the path is unclear, a human decides.
  • If you cannot explain who owns it in one sentence, it is not ready.
  • If it drives access, it must not be self-service.
  • If nobody reads it, do not create it.
  • If two teams both claim it, the data owner decides and records the reason.
Analogy

Before cutting a new door in a wall, you check whether an existing door could be widened. The simplest answer that works is usually the safest.

61Small Details That Decide Success

Most mastering projects stumble on small details that nobody wrote down.

1

Trailing spaces and case

“Finance ” and “finance” are different strings to many systems. Clean values as they enter.

2

Time zones

A start date at midnight in one zone is the previous day in another.

3

Leading zeros

Employee number 00457 stored as a number becomes 457, and no longer matches.

4

Special characters in names

Accents and apostrophes break poorly built mappings and feeds.

5

Holiday and weekend runs

Feeds often skip days off. Check that terminations are not delayed by three days.

6

Test accounts

Keep them out of production reports, and make sure they cannot be mistaken for real people.

7

Display names in other tools

Some tools cache names for weeks. Know which ones.

Analogy

A hotel is judged by clean towels, a working key card and a quiet corridor more than by its marble lobby. Small things are what guests remember.

62A Week in the Life of a Healthy Mastering Program

Success looks quiet: small routines, few surprises and no heroic rescues.

1

Monday: the scorecard

The owner reads the weekly data quality scorecard. Three profiles lack a manager. The list goes to HR.

2

Tuesday: a name change

HR records a legal name change. By the next morning every connected tool shows the new name.

3

Wednesday: a request

A team asks for a new attribute. The decision guide shows an existing field already covers it. No new field is created.

4

Thursday: a safety stop

An HR file arrives with half the usual rows. The safety cap halts the import and alerts the team. HR sends a corrected file within the hour.

5

Friday: a review

One attribute reaches its yearly review. The owner confirms it is still used and still mastered correctly.

Notice what is missing: no weekend outage, no mystery values and nobody asking where a field came from. That calm is the real product of careful work.

Analogy

A well-run railway is boring. Trains leave on time and signals work. The boredom is the sign that careful work happens every day behind the scenes.

63Common Mistakes in the First Year

Teams repeat the same early mistakes. Knowing them in advance is a cheap kind of experience.

MistakeWhat it causesCure
Skipping the ownership mapEndless disputes and ad hoc rulesWrite it first, and review it with all owners
Connecting every source at onceConflicts nobody can untangleStart with HR and one directory
Trusting the data blindlyOld mess imported as truthClean and sample before importing
Two-way flows by habitLoops and flipping valuesOne direction per field
No safety capsOne bad file causes an outageCaps and alerts on every import
Editable access-driving fieldsSelf-granted privilegesControl and audit those fields
No restore practiceSlow, risky repairSnapshots and a rehearsed restore
No quality routineSlow decayWeekly scorecard and monthly cleanups
Analogy

New drivers repeat the same few errors: following too close, forgetting mirrors, taking corners fast. Hearing about them does not replace practice, but it shortens the learning.

64Getting Colleagues on Board: Change Management

A clear strategy that people work around protects nothing. Source owners must agree, and they must see why.

  • Explain benefits in their terms. HR hears “fewer correction requests.” Security hears “faster leaver removal.” Application owners hear “correct data without custom scripts.”
  • Make the map visible. One page everyone can read and challenge.
  • Give source owners a feedback loop. Weekly lists of exceptions that belong to them, with examples.
  • Provide a fast request route. If new attributes take months, teams will invent side systems.
  • Pilot with a friendly team. Collect a success story.
  • Close old paths. Retire scripts, spreadsheets and direct database changes that bypass the arrangement.
  • Report progress. Share timing and quality improvements with leaders.
Analogy

When a town builds a new bridge, it also closes the old rickety crossing and puts up signs. A new road that nobody is told about leaves traffic on the old, dangerous one.

65Documentation That Survives Staff Changes

Engineers and analysts move on. A mastering arrangement that only one person understands is a risk with a name and a leaving date.

Question a stranger would askWhere the answer lives
Which system masters this attribute, and why?The ownership map
Which priority order applies?The priority register
How does a record get matched?The matching guide
What happens when a feed is empty or late?The runbook
How do I test a change?The test plan
How do I restore data?The recovery steps
Who do I call at each source?The contact list

Once a year, ask someone new to follow the runbook in a test copy. Wherever they stumble, the document needs work.

Analogy

A ship’s log lets a new captain understand the voyage so far. Without it, the new captain learns about the leak by getting wet.

66Glossary of Terms

Quick plain-language meanings for the words used in this guide.

TermMeaning
Application-masteredAn attribute whose value is owned by an outside application
AttributeOne field in a profile
ConflictTwo sources giving different values for the same fact
ConsumerA system that receives a value but does not own it
Custom attributeA field you define yourself in the profile
ImportBringing data from a source into Okta
MappingThe rule linking a field in one profile to a field in another
MatchingDeciding which incoming record belongs to which person
NormalizationWriting the same fact in one standard form
Okta-masteredAn attribute whose value is owned inside Okta
Ownership mapA table naming the master of every attribute
PriorityThe order that decides which source wins
Profile masterThe system whose value wins for a person or attribute
Profile sourceA system that supplies users or attributes to Okta
PushSending data from Okta to an application
ReconciliationComparing two copies and fixing differences
Safety capA limit that stops an import that would change too much
Self-serviceAn attribute the person may edit themselves
Universal DirectoryOkta’s central store of user profiles
Write-backSending a value from Okta back to a source system
Analogy

A traveler’s phrasebook does not make you fluent, but it stops misunderstandings at the market. A glossary does the same in the meeting.

67Frequently Asked Questions

Short answers to questions that come up in almost every project.

Q1Should HR always be the master?
For employment facts such as legal name, employee number, manager, job, status and dates, HR is almost always the right master. For contact details people maintain themselves, or facts only one application knows, other masters make sense. Decide attribute by attribute.
Q2Can two systems master the same attribute?
Avoid it. If two sources must supply the same fact, set a clear priority order so that one wins, and document why. Equal masters lead to flipping values.
Q3What if the HR data is poor?
Fix it at the source with the HR data steward, using weekly exception lists. Do not hide poor data by making another system the master unless that system truly knows better.
Q4Should users edit their own profile?
Yes for personal and low-risk fields such as preferred name, photo and mobile phone. No for anything that drives access, such as department, manager, job code or status.
Q5How often should we import?
Match speed to harm. Terminations need minutes to an hour. Hires and transfers need a day. Titles and phone numbers can be slower. Confirm the schedule options and limits for your HR integration.
Q6What should happen with blank values?
Protect critical fields from accidental blanks, use safety caps, and test with incomplete files. Where a blank is meaningful, ask the source to send an explicit empty marker.
Q7How do we handle a merger?
Keep both HR sources as masters for their own populations first, mark each profile’s origin, avoid key collisions, and migrate in waves toward a single master with a date.
Q8What do we do about duplicates?
Use strong matching keys, flag possible duplicates for human review and never merge automatically on weak keys such as names.
Q9Does Okta support attribute-level mastering?
Okta provides ways to rank profile sources and decide which attributes each may supply. The exact features and screens depend on your product and edition, so confirm in current documentation before designing around them.
Q10Who should own the ownership map?
An identity data owner, with a deputy, accountable to security and HR leaders. Source owners contribute and approve changes to their own attributes.
Analogy

A good help desk answers the same ten questions every day with the same calm sentences. Writing the answers down is how a team stays consistent.

68Summary and Key Takeaways

Profile mastering is the habit of deciding, once and clearly, which system tells the truth about each fact. Everything else, from access to approvals to audits, gets simpler when that decision is made and kept.

Key Takeaways

  • One master per fact. Choose by who creates, owns, keeps fresh and can be trusted to keep each attribute right, not by convenience.
  • Write the ownership map. A table with master, direction, reason and freshness for every attribute is the core document of the project.
  • One direction per field. Two-way flows create loops. Use short, tested priority orders when several sources must supply a value.
  • Protect critical data. Use stable matching keys, safety caps and alerts so that one bad feed cannot wipe or lock out the company.
  • Guard access-driving fields. Department, manager, worker type and status must come from controlled masters and never from self-service.
  • Change in steps. Test in a safe copy, snapshot first, release in waves, and keep a practiced way back.
  • Run it as a program. Name owners, publish quality scorecards, send exceptions to source owners, review quarterly and save evidence.