Agregar y quitar delegados mediante EWS en Exchange
Obtenga información sobre cómo agregar delegados a o quitar delegados de los buzones de los usuarios mediante la API administrada de EWS o EWS en Exchange.
Puede usar la API administrada de EWS o EWS para permitir que los delegados actúen en nombre del propietario de un buzón o quiten el acceso de un delegado a un buzón. Los usuarios que se agregan como delegado y tienen permisos pueden realizar tareas en nombre del propietario del buzón. Por ejemplo, pueden crear y enviar invitaciones a reuniones, enviar correos electrónicos y responder a las convocatorias de reunión en nombre del propietario del buzón.
Tabla 1. Métodos de API administrada de EWS y operaciones de EWS para agregar y quitar delegados
| Task | Método de la API administrada de EWS | Operación de EWS |
|---|---|---|
| Agregar delegados |
ExchangeService.AddDelegates |
AddDelegate |
| Quitar delegados |
ExchangeService.RemoveDelegates |
RemoveDelegate |
Después de conceder permisos a un delegado a una carpeta, pueden actuar en los elementos de la carpeta y en cualquier subcarpeta, según sus permisos de delegado. Los permisos para delegados solo se aplican a las subcarpetas que se crean después de conceder el acceso de delegado. Para actualizar los permisos de carpeta para carpetas existentes u otras carpetas, vea Establecer permisos de carpeta para otro usuario mediante EWS en Exchange.
Tenga en cuenta que los delegados solo se pueden agregar a cuentas habilitadas para buzones, incluidos los grupos de seguridad habilitados para correo. De forma predeterminada, una única llamada de acceso de delegado de EWS puede tener acceso a un máximo de 255 buzones diferentes.
Agregar delegados mediante la API administrada de EWS
Puede agregar delegados a un buzón mediante el método AddDelegates EWS Managed API. En este ejemplo, se crea un nuevo objeto DelegateUser de calendario, contacto y correo electrónico, y a cada delegado se le conceden permisos de Editor para su carpeta respectiva. Puede modificar el ejemplo para agregar un delegado a cualquiera de las carpetas especificadas por las propiedades DelegatePermissions y puede establecer los permisos en cualquiera de los valores especificados por la enumeración DelegateFolderPermissionLevel .
En este ejemplo se supone que el servicio es un objeto ExchangeService válido para el propietario del buzón de correo y que el usuario se ha autenticado en un servidor exchange.
public static Collection<DelegateUserResponse> AddDelegates(ExchangeService service)
{
// Create a list to hold the new delegates to add.
List<DelegateUser> newDelegates = new System.Collections.Generic.List<DelegateUser>();
// Create a new delegate that has editor access to the mailbox owner's Calendar folder.
DelegateUser calendarDelegate = new DelegateUser("calendardelegate@contoso.com");
calendarDelegate.Permissions.CalendarFolderPermissionLevel = DelegateFolderPermissionLevel.Editor;
// Add the delegate to the list of new delegates.
newDelegates.Add(calendarDelegate);
// Create a new delegate that has editor access to the mailbox owner's Contacts folder.
DelegateUser contactDelegate = new DelegateUser("contactdelegate@contoso.com");
contactDelegate.Permissions.ContactsFolderPermissionLevel = DelegateFolderPermissionLevel.Editor;
// Add the delegate to the list of new delegates.
newDelegates.Add(contactDelegate);
// Create a new delegate that has editor access to the mailbox owner's Inbox folder.
DelegateUser emailDelegate = new DelegateUser("emaildelegate@contoso.com");
emailDelegate.Permissions.InboxFolderPermissionLevel = DelegateFolderPermissionLevel.Editor;
// Add the delegate to the list of new delegates.
newDelegates.Add(emailDelegate);
// Create a mailbox object that represents the mailbox owner.
Mailbox mailbox = new Mailbox("primary@contoso.com");
// Call the AddDelegates method to add the delegates to the target mailbox.
Collection<DelegateUserResponse> response = service.AddDelegates(mailbox, MeetingRequestsDeliveryScope.DelegatesAndSendInformationToMe, newDelegates);
foreach (DelegateUserResponse resp in response)
{
// Print out the result and the last eight characters of the item ID.
Console.WriteLine("For delegate " + resp.DelegateUser.UserId.PrimarySmtpAddress.ToString());
Console.WriteLine("Result: {0}", resp.Result);
Console.WriteLine("Error Code: {0}", resp.ErrorCode);
Console.WriteLine("ErrorMessage: {0}\r\n", resp.ErrorMessage);
Console.WriteLine("\r\n");
}
return response;
}
Adición de delegados mediante EWS
En el ejemplo de código siguiente se muestra cómo agregar delegados de calendario, contacto y correo electrónico independientes mediante la operación EWS AddDelegate . El buzón que se va a modificar se especifica mediante el elemento Mailbox y la configuración de permisos para cada delegado se incluye en el elemento DelegateUser . A cada uno de los delegados se le han concedido permisos de Editor a su carpeta de destino.
Esta es también la solicitud XML que envía la API administrada de EWS cuando se usa el método AddDelegates para agregar delegados.
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/">
<soap:Header>
<t:RequestServerVersion Version="Exchange2007_SP1" />
</soap:Header>
<soap:Body>
<m:AddDelegate>
<m:Mailbox>
<t:EmailAddress>primary@contoso.com</t:EmailAddress>
</m:Mailbox>
<m:DelegateUsers>
<t:DelegateUser>
<t:UserId>
<t:PrimarySmtpAddress>calendardelegate@contoso.com</t:PrimarySmtpAddress>
</t:UserId>
<t:DelegatePermissions>
<t:CalendarFolderPermissionLevel>Editor</t:CalendarFolderPermissionLevel>
<t:TasksFolderPermissionLevel>None</t:TasksFolderPermissionLevel>
<t:InboxFolderPermissionLevel>None</t:InboxFolderPermissionLevel>
<t:ContactsFolderPermissionLevel>None</t:ContactsFolderPermissionLevel>
<t:NotesFolderPermissionLevel>None</t:NotesFolderPermissionLevel>
<t:JournalFolderPermissionLevel>None</t:JournalFolderPermissionLevel>
</t:DelegatePermissions>
<t:ReceiveCopiesOfMeetingMessages>false</t:ReceiveCopiesOfMeetingMessages>
<t:ViewPrivateItems>false</t:ViewPrivateItems>
</t:DelegateUser>
<t:DelegateUser>
<t:UserId>
<t:PrimarySmtpAddress>contactdelegate@contoso.com</t:PrimarySmtpAddress>
</t:UserId>
<t:DelegatePermissions>
<t:CalendarFolderPermissionLevel>None</t:CalendarFolderPermissionLevel>
<t:TasksFolderPermissionLevel>None</t:TasksFolderPermissionLevel>
<t:InboxFolderPermissionLevel>None</t:InboxFolderPermissionLevel>
<t:ContactsFolderPermissionLevel>Editor</t:ContactsFolderPermissionLevel>
<t:NotesFolderPermissionLevel>None</t:NotesFolderPermissionLevel>
<t:JournalFolderPermissionLevel>None</t:JournalFolderPermissionLevel>
</t:DelegatePermissions>
<t:ReceiveCopiesOfMeetingMessages>false</t:ReceiveCopiesOfMeetingMessages>
<t:ViewPrivateItems>false</t:ViewPrivateItems>
</t:DelegateUser>
<t:DelegateUser>
<t:UserId>
<t:PrimarySmtpAddress>emaildelegate@contoso.com</t:PrimarySmtpAddress>
</t:UserId>
<t:DelegatePermissions>
<t:CalendarFolderPermissionLevel>None</t:CalendarFolderPermissionLevel>
<t:TasksFolderPermissionLevel>None</t:TasksFolderPermissionLevel>
<t:InboxFolderPermissionLevel>Editor</t:InboxFolderPermissionLevel>
<t:ContactsFolderPermissionLevel>None</t:ContactsFolderPermissionLevel>
<t:NotesFolderPermissionLevel>None</t:NotesFolderPermissionLevel>
<t:JournalFolderPermissionLevel>None</t:JournalFolderPermissionLevel>
</t:DelegatePermissions>
<t:ReceiveCopiesOfMeetingMessages>false</t:ReceiveCopiesOfMeetingMessages>
<t:ViewPrivateItems>false</t:ViewPrivateItems>
</t:DelegateUser>
</m:DelegateUsers>
<m:DeliverMeetingRequests>DelegatesAndSendInformationToMe</m:DeliverMeetingRequests>
</m:AddDelegate>
</soap:Body>
</soap:Envelope>
El servidor responde a la solicitud AddDelegate con un mensaje AddDelegateResponse que incluye un valor de elemento ResponseCode de NoError, lo que indica que los delegados se crearon correctamente.
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="https://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:ServerVersionInfo MajorVersion="15"
MinorVersion="0"
MajorBuildNumber="888"
MinorBuildNumber="9"
Version="V2_10"
xmlns:h="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" />
</s:Header>
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<m:AddDelegateResponse ResponseClass="Success"
xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
<m:ResponseCode>NoError</m:ResponseCode>
<m:ResponseMessages>
<m:DelegateUserResponseMessageType ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:DelegateUser>
<t:UserId>
<t:SID>S-1-5-21-1337771579-694202782-848329751-1535221</t:SID>
<t:PrimarySmtpAddress>calendardelegate@contoso.com</t:PrimarySmtpAddress>
<t:DisplayName>calendardelegate</t:DisplayName>
</t:UserId>
<t:ReceiveCopiesOfMeetingMessages>false</t:ReceiveCopiesOfMeetingMessages>
<t:ViewPrivateItems>false</t:ViewPrivateItems>
</m:DelegateUser>
</m:DelegateUserResponseMessageType>
<m:DelegateUserResponseMessageType ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:DelegateUser>
<t:UserId>
<t:SID>S-1-5-21-1337771579-694202782-848329751-1535264</t:SID>
<t:PrimarySmtpAddress>contactdelegate@contoso.com</t:PrimarySmtpAddress>
<t:DisplayName>contactdelegate</t:DisplayName>
</t:UserId>
<t:ReceiveCopiesOfMeetingMessages>false</t:ReceiveCopiesOfMeetingMessages>
<t:ViewPrivateItems>false</t:ViewPrivateItems>
</m:DelegateUser>
</m:DelegateUserResponseMessageType>
<m:DelegateUserResponseMessageType ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:DelegateUser>
<t:UserId>
<t:SID>S-1-5-21-1337771579-694202782-848329751-1535223</t:SID>
<t:PrimarySmtpAddress>emaildelegate@contoso.com</t:PrimarySmtpAddress>
<t:DisplayName>emaildelegate</t:DisplayName>
</t:UserId>
<t:ReceiveCopiesOfMeetingMessages>false</t:ReceiveCopiesOfMeetingMessages>
<t:ViewPrivateItems>false</t:ViewPrivateItems>
</m:DelegateUser>
</m:DelegateUserResponseMessageType>
</m:ResponseMessages>
</m:AddDelegateResponse>
</s:Body>
</s:Envelope>
Eliminación de delegados mediante la API administrada de EWS
Puede quitar delegados de un buzón de destino mediante el método de API administrada de EWS ExchangeService.RemoveDelegates . En este ejemplo, se quitan los permisos de delegado establecidos en el ejemplo agregar un delegado .
En este ejemplo se supone que el servicio es un objeto ExchangeService válido para el propietario del buzón de correo y que el usuario se ha autenticado en un servidor exchange.
public static Collection<DelegateUserResponse> RemoveDelegates(ExchangeService service)
{
// Create a list to hold the delegates to delete.
List<UserId> deletedDelegates = new System.Collections.Generic.List<UserId>();
// Add the delegate to the list of new delegates.
deletedDelegates.Add("calendardelegate@contoso.com");
// Add the delegate to the list of new delegates.
deletedDelegates.Add("contactdelegate@contoso.com");
// Add the delegate to the list of new delegates.
deletedDelegates.Add("emaildelegate@contoso.com");
// Create a mailbox object that represents the mailbox owner.
Mailbox mailbox = new Mailbox("primary@contoso.com");
// Call the AddDelegates method to add the delegates to the target mailbox.
Collection<DelegateUserResponse> response = service.RemoveDelegates(mailbox, deletedDelegates);
foreach (DelegateUserResponse resp in response)
{
// Print out the result and the last eight characters of the item ID.
Console.WriteLine("Result: {0}", resp.Result);
Console.WriteLine("Error Code: {0}", resp.ErrorCode);
Console.WriteLine("ErrorMessage: {0}\r\n", resp.ErrorMessage);
}
return response;
}
Quitar delegados mediante EWS
Puede quitar delegados de un buzón mediante la operación RemoveDelegate EWS. En este ejemplo, se quitan los permisos de delegado establecidos en el ejemplo agregar un delegado .
Esta es también la solicitud XML que la API administrada de EWS envía cuando se usa el método RemoveDelegates para quitar delegados.
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/">
<soap:Header>
<t:RequestServerVersion Version="Exchange2007_SP1" />
</soap:Header>
<soap:Body>
<m:RemoveDelegate>
<m:Mailbox>
<t:EmailAddress>primary@contoso.com</t:EmailAddress>
</m:Mailbox>
<m:UserIds>
<t:UserId>
<t:PrimarySmtpAddress>calendardelegate@contoso.com</t:PrimarySmtpAddress>
</t:UserId>
<t:UserId>
<t:PrimarySmtpAddress>contactdelegate@contoso.com</t:PrimarySmtpAddress>
</t:UserId>
<t:UserId>
<t:PrimarySmtpAddress>emaildelegate@contoso.com</t:PrimarySmtpAddress>
</t:UserId>
</m:UserIds>
</m:RemoveDelegate>
</soap:Body>
</soap:Envelope>
El servidor responde a la solicitud RemoveDelegate con un mensaje AddDelegateResponse que incluye un valor de elemento ResponseCode de NoError, lo que indica que los delegados se quitaron correctamente.
Pasos siguientes
Después de agregar delegados a carpetas de calendario, correo electrónico y tareas, el delegado puede acceder a los elementos de las carpetas. Para más información, consulte los artículos siguientes:
Acceso al correo electrónico como delegado mediante EWS en Exchange
Obtener acceso a un calendario como delegado mediante EWS en Exchange
Si las carpetas para las que agregó delegados incluyen carpetas secundarias que se crearon antes de conceder el acceso delegado, el delegado no podrá acceder a esas carpetas sin permisos adicionales. Para agregar estos permisos o modificar permisos para cualquier otra carpeta, vea Establecer permisos de carpeta para otro usuario mediante EWS en Exchange.
Recursos adicionales
- Acceso delegado y EWS en Exchange
- Exchange 2013: Agregar usuarios delegados a una cuenta de correo electrónico mediante programación
- Exchange 2013: actualizar delegados asociados a cuentas de correo electrónico mediante programación
- Exchange 2013: quitar delegados asociados a cuentas de correo electrónico mediante programación
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de