MULE MICROSOFT SHAREPOINT 2013

CONNECTORBY – ANKUSH SHARMA

MULE MICROSOFT SHAREPOINT 2013 CONNECTOR

• Microsoft SharePoint is a web application platform for content and document management, intranet portals, collaboration, extranets, websites, and enterprise search.

• The Microsoft SharePoint connector for Anypoint platform enables integration with SharePoint 2013 through its REST API.

AUTHENTICATION

• The Microsoft SharePoint connector supports different authentication schemes based on whichMicrosoft SharePoint that you access:

• Supported Microsoft SharePoint authentication on-premise:

• NTLM

• Claims-based authentication against Microsoft ADFS

• Unsupported authentication: Kerberos

• Supported Microsoft SharePoint Online authentication:

• Microsoft Online (Office 365) managed users

• Microsoft Online (Office 365) federated users against Microsoft ADFS

CLAIMS-BASED AUTHENTICATION• Configuring the connector to use claims-based authentication requires the following information from the Security

Token Service (STS) that to use for authenticating:

• Sts Url: The STS endpoint that accepts username and password for authenticating users and understands the WS-Trust 1.3 protocol. When the STS is Microsoft’s ADFS (Active Directory Federation Services), this URL usually is https://youradfs.com/adfs/services/trust/13/usernamemixed.

• Sts App Identifier: A string that identifies the Sharepoint site in the STS. It is also known as Relying Party Identifier, Client Identifier, Scope, or Realm. When the STS is Microsoft’s ADFS, this value can be discovered in the AD FS Management console under AD FS at Trust Relationships > Relying Party Trusts > (Sharepoint Site’s relying part properties) > Identifiers tab.

• You can obtain the STS App Identifier by logging into the Sharepoint Site that you want to be accessed by opening the Site URL in a web browser. If there is more than one authentication provider configured for a site, a drop-down menu lists the options. Select the desired STS to be redirected to the STS’s login page. At this point, the address bar of the web browser contains a URL that includes the following query parameters:

wa=wsignin1.0&wtrealm=uri%3amule%3asp80

• The parameter wa tells the STS that a sign in is being initiated. The wtrealm contains the URI-encoded value for the Sts App Identifier. In the example, uri%3amule%3asp80 is uri:mule:sp80. The unencoded value is the parameter for the connector’s configuration.

MULE MICROSOFT SHAREPOINT 2013 CONNECTOR –CONFIGURATION WIZARD(GENERAL TAB) (CONT.)

MULE MICROSOFT SHAREPOINT 2013 CONNECTOR –CONFIGURATION WIZARD(GENERAL TAB)

• Following are the options on general tab –• Display Name – The name of the connector to be displayed in Mule flow.

• Connector Configuration – The reference to the global connector configuration.

• Operation – Determines the operation to be performed on Microsoft server.

MULE MICROSOFT SHAREPOINT 2013 CONNECTOR – CONNECTOR CONFIGURATION WIZARD(GENERAL TAB) (CONT.)

MULE MICROSOFT SHAREPOINT 2013 CONNECTOR – CONNECTOR CONFIGURATION WIZARD(GENERAL TAB)

• Following are the options on general tab –

• Name – The name of the global connector configuration.

• Username – The username provided by Microsoft(without domain).

• Password – Password used to authenticated the user.

• Site Url – Sharepoint endpoint URL.

• Sts Url – Security Token Service URL to use for claims authentication.

• Sts App Identifier – Application Identifier configured for this Sharepoint Site in the Sts.

MULE MICROSOFT SHAREPOINT 2013 CONNECTOR – CONNECTOR CONFIGURATION WIZARD(POOLING PROFILE TAB) (CONT.)

MULE MICROSOFT SHAREPOINT 2013 CONNECTOR – CONNECTOR CONFIGURATION WIZARD(POOLING PROFILE TAB)• Mule Microsoft Sharepoint connector configuration’s pooling profile tab contains following properties –

• Use default connection pool config – This radio button is used enable default connection pooling setting of this connector.

• Define connection pool config – Radio button used to create custom connection pooling settings.

• Max active – Property which define how many connections can be there in connection pool.

• Max idle – Defines maximum number of connections that can be idle.

• Initialization policy – Defines how to initialize new connections.

• Exhausted action – Defines how to release a connection after usage.

• Max wait – Maximum time to wait for a new connection to be available.

• Min eviction time – Minimum amount of time a connection can sit idle for.

MULE MICROSOFT SHAREPOINT 2013 CONNECTOR – CONNECTOR CONFIGURATION WIZARD(RECONNECTION TAB) (CONT.)

MULE MICROSOFT SHAREPOINT 2013 CONNECTOR – CONNECTOR CONFIGURATION WIZARD(RECONNECTION TAB)• The Reconnection tab contains following properties –

• Do not use a Reconnection Strategy – This is the default radio button which specifies do not try to reconnect if there is error connecting to the web address URL.

• Standard Reconnection – Use this radio button to enable a standard reconnection strategy.

• Frequency (ms) – The frequency time in milliseconds after which the connector will try to access the web address URL.

• Reconnect Attempts – This tells how many times the AJAX connector will try to connect to web address URL.

• Reconnector Forever – Check this box if there is need to make connector connect to web address URL until there is a successful connection with it.

• Custom Reconnection – Use this radio button to create a custom Reconnection strategy.

• Class – The java class which will come in action after a failed connection attempt.

• Run the connection in a separated thread – Check this box if there is need to use this custom reconnection operation in separate thread.

MULE MICROSOFT SHAREPOINT 2013 – CONFIGURATION WIZARD (NOTES TAB)

• The Notes Tab is used to add special notes for Mule Microsoft Sharepoint 2013 Connector.

THANK YOU!