Skip to content

Commit 8c1ea67

Browse files
authored
Incorporate some Acrolinx feedback
Updated the article to clarify changes regarding the '# SSSAdminProd' user in server-side sync operations, including symptoms, causes, and FAQs.
1 parent deea502 commit 8c1ea67

1 file changed

Lines changed: 13 additions & 13 deletions

File tree

support/power-platform/dataverse/email-exchange-synchronization/server-side-synchronization-new-admin-identity.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ ms.date: 13/11/2025
66

77
# SSSAdminProd user and server-side sync operations
88

9-
This article provides an overview of the changes customers can expect and will observe when server-side sync transitions to a new identity to communicate with Dataverse.
9+
This article provides an overview of the changes customers can expect when server-side sync transitions to a new identity to communicate with Dataverse.
1010

1111
## Symptoms
1212

@@ -16,16 +16,16 @@ This article provides an overview of the changes customers can expect and will o
1616
1717
## Cause
1818

19-
Server-side sync is changing the the identity used for its operations against Dataverse. Historically, server-side sync would simply leverage the user named SYSTEM that all environments have. Moving forward, server-side sync operations will transition to use the '# SSSAdminProd' user. However, to preserve backward compatibility, the SYSTEM identity will still be leveraged for some key server-side sync operations. This is to ensure that customer dependencies built on this identity are not impacted by this change.
19+
Server-side sync is changing the identity used for its operations against Dataverse. Historically, server-side sync would simply use the user named SYSTEM that all environments have. Moving forward, server-side sync operations will transition to use the '# SSSAdminProd' user. However, to preserve backward compatibility, the SYSTEM identity will still be used for some key server-side sync operations, which ensures that this change does not impact customer dependencies built around this identity.
2020

21-
These are the key differences you can expect:
21+
The key differences customers can expect are:
2222
1. For records created or updated by server-side sync, the delegate auditing fields "Created By (delegate)" and "Mofieid By (delegate)" will start showing the '# SSSAdminProd' user instead of being empty. The content of the "Created By" and "Modified By" fields remains unchanged.
2323
2. For records created by synchronous customizations (such as workflows or plug-ins) running upon server-side sync operations and using the calling identity, the "Created By (delegate)" field will start showing the '# SSSAdminProd' user instead of being empty.
2424
3. The audit log entries for server-side sync operations that do not impersonate a system user will change from SYSTEM to '# SSSAdminProd'
2525

26-
Below are a few sample scenarios to demonstrate what is changing and what is not. This is not a comprehensive list of scenarios.
26+
The following are a few sample scenarios to demonstrate what is changing and what is not (not a comprehensive list):
2727

28-
### Scenario 1: an email in 'Pending Send' state is picked up by server-side sync, sent out, and moved to 'Sent' state through a 'SetState' operation. A synchronous workflow runs on email update to create a contact using the calling identity
28+
### Scenario 1: server-side sync picks up an email in 'Pending Send' state, sends it out, and moves it to 'Sent' state through a 'SetState' operation. A synchronous workflow runs on email update to create a contact using the calling identity
2929

3030
|Scenario|Email Modified By|Email Modified By (delegate)|Email audit log identity|Contact owner|Contact Created By|Contact Created By (delegate)|Contact audit log identity|
3131
|-|-|-|-|-|-|-|-|
@@ -39,7 +39,7 @@ Below are a few sample scenarios to demonstrate what is changing and what is not
3939
|Before|SYSTEM|**SYSTEM**|SYSTEM|**SYSTEM**|**SYSTEM**|SYSTEM|SYSTEM|**Empty**|SYSTEM|
4040
|After|SYSTEM|**'# SSSAdminProd'**|SYSTEM|**'# SSSAdminProd'**|**'# SSSAdminProd'**|SYSTEM|SYSTEM|**'# SSSAdminProd'**|SYSTEM|
4141

42-
### Scenario 3: an email is automatically tracked into Dynamics, for which server-side sync uses the DeliverIncoming SDK message. A synchronous plug-in runs on email create to create a contact using the calling identity
42+
### Scenario 3: an email is automatically tracked into Dynamics, for which server-side sync uses the DeliverIncoming SDK message. A plug-in runs synchronously on email creation to create a contact using the calling identity
4343

4444
|Scenario|Email Created By|Email Created By (delegate)|Email audit log identity|Contact owner|Contact Created By|Contact Created By (delegate)|Contact audit log identity|
4545
|-|-|-|-|-|-|-|-|
@@ -53,14 +53,14 @@ Below are a few sample scenarios to demonstrate what is changing and what is not
5353
|Before|SYSTEM|**SYSTEM**|**SYSTEM**|SYSTEM|SYSTEM|**Empty**|SYSTEM|
5454
|After|SYSTEM|**'# SSSAdminProd'**|**'# SSSAdminProd'**|SYSTEM|SYSTEM|**'# SSSAdminProd'**|SYSTEM|
5555

56-
### Scenario 5: a task is tracked into Dynamics by server-side sync, which impersonates the actual user. A synchronous workflow runs on task create to create a contact using the calling identity
56+
### Scenario 5: server-side sync tracks a task into Dynamics while impersonating the actual user. A synchronous workflow runs on task create to create a contact using the calling identity
5757

5858
|Scenario|Task Created By|Task Created By (delegate)|Task Modified By|Task Modified By (delegate)|Task audit log identity|Contact owner|Contact Created By|Contact Created By (delegate)|Contact audit log identity|
5959
|-|-|-|-|-|-|-|-|-|-|
6060
|Before|User|**Empty**|User|**Empty**|User|User|User|**Empty**|User|
6161
|After|User|**'# SSSAdminProd'**|User|**'# SSSAdminProd'**|User|User|User|**'# SSSAdminProd'**|User|
6262

63-
### Scenario 6: an appointment is tracked into Dynamics through server-side sync by a mailbox belonging to a user that is different from the appointment organizer, for which server-side sync does not use impersonation. A synchronous workflow runs on appointment create to create a contact using the calling identity
63+
### Scenario 6: an appointment is tracked into Dynamics through server-side sync. The tracking mailbox belongs to a user that is different from the appointment organizer, so which server-side sync does not use impersonation. A synchronous workflow runs on appointment create to create a contact using the calling identity
6464

6565
|Scenario|Appointment Created By|Appointment Created By (delegate)|Appointment Modified By|Appointment Modified By (delegate)|Appointment audit log identity|Contact owner|Contact Created By|Contact Created By (delegate)|Contact audit log identity|
6666
|-|-|-|-|-|-|-|-|-|-|
@@ -69,25 +69,25 @@ Below are a few sample scenarios to demonstrate what is changing and what is not
6969

7070
## Resolution
7171

72-
No action should be required, server-side sync would continue functioning as normal after the transition.
72+
No action should be required. Server-side sync would continue functioning as normal after the transition.
7373

7474
## FAQ
7575

7676
### 1. When will this transition take place?
7777

78-
This is currently planned to happen somewhere between November 2025 and March 2026.
78+
This transition is currently planned to happen somewhere between November 2025 and March 2026.
7979

8080
### 2. Can I opt out of it?
8181

8282
There is no way to opt out of this change, but you should contact support if anything breaks after transition.
8383

84-
### 3. Moving forward, can we build dependencies (in the form of customizations, processes, etc.) around the fact that server-side sync operations are performed by '# SSSAdminProd'?
84+
### 3. Moving forward, can we build dependencies (in the form of customizations, processes, etc.) around the fact that server-side sync performs its operations using '# SSSAdminProd'?
8585

8686
No. Much like the identity is changing now, it is also subject to changing again in the future, so any such dependencies could break.
8787

88-
### 4. We have built dependencies or processes around the identities that show up in the audit log or the delegate auditing fields when operations are performed by server-side sync. What should we do?
88+
### 4. We built dependencies or processes around the identities that show up in the audit log or the delegate auditing fields when operations are performed by server-side sync. These identities are now changing. What should we do?
8989

90-
As these identities can and will be changing, we we advise against building dependencies around observations and assumptions about how the system behaves at a particular point in time, and instead refer to publicly documented system behaviors.
90+
As these identities can and will be changing, we advise against building dependencies around observations and assumptions about how the system behaves at a particular point in time. Instead, refer to publicly documented system behaviors.
9191

9292
### 5. We are not using server-side sync. Why is this user present? Can we disable it?
9393

0 commit comments

Comments
 (0)