S H A R E P O I N T CONFERENCES
2014
Elaine van BergenChris O’Connor bit.ly/
STP1426
Integrating Yammer with SharePoint
#auspc #nzspc
Agenda
What’s available OOB
Authentication
Embed
Rest API
#auspc #nzspc
What’s Available OOB
Integration options with no code
#auspc #nzspc
Demo
Yammer integrated features
#auspc #nzspc
Features OOB
SharePoint 2013 SP1 – Newsfeed replacement
Office 365 for the most integrated experience
Embed for any platform
#auspc #nzspc
Authentication
Infrastructure components before coding
#auspc #nzspc
Why worry about authentication Need to preserve user experience Single connected system not two separate
#auspc #nzspc
DSync or SSO, or both?
Directory Sync
Single Sign-On
Sweet spot
Provisioning Authentication
#auspc #nzspc
SSO Deployment processProcess is not self-service
If you have a SAML 2.0 Identity Provider then configuration is pretty straightforward
Tests happen against your Yammer network at a scheduled time
Provide identity provider metadata
Yammer implements service provider configuration
Create Relying Party Trust with Yammer metadata
Test SSO
Make email address changesActivate SSO
#auspc #nzspc
Deploying Directory Sync
Installs on a single server
No database required
AD and LDAP expertise required to configure custom filters (queries)
First sync sends all data, subsequent syncs are incremental
Install Directory Sync
Connect to Yammer
Connect to AD
Validate user queries
Enable syncs
#auspc #nzspc
Embed
Basic integration
#auspc #nzspc
Browser Considerations 400px (or beta skinny mode) Desktop Only
Internet Explorer 12+, 11, 10 IE9 (until approx. 31/12/2015) IE8 (until approx. 31/12/2014)
Chrome newest version Firefox newest version Safari newest version
“Trusted Site Zone”
#auspc #nzspc
Demo
Embed
#auspc #nzspc
More information Yammer developer site
Widget example
Blog post example by Vesa Some examples use the old API – be careful…
Yammer app for SharePoint
#auspc #nzspc
REST API
Deeper Integration
#auspc #nzspc
REST End points
Autocomplete Invitations Suggestions Networks
Messages Users Groups Search Activities
#auspc #nzspc
REST Overview
Object URIMessages https://www.yammer.com/api/v1/messages.json
https://www.yammer.com/api/v1/messages/my_feed.jsonhttps://www.yammer.com/api/v1/messages/following.jsonhttps://www.yammer.com/api/v1/messages/private.json
Groups https://www.yammer.com/api/v1/group_memberships.json?group_id=[:id]
Users https://www.yammer.com/api/v1/users.jsonhttps://www.yammer.com/api/v1/users/current.json
Notifications https://www.yammer.com/api/v1/streams/notifications.json
Search https://www.yammer.com/api/v1/search.json
#auspc #nzspc
Register an App First ! Register App first in Yammer first Note the Client ID and Secret
#auspc #nzspc
AuthorisationAuthorization
Redirect user to the OAuth dialog URL.
Process the response at your Redirect URI when user allows the app.
#auspc #nzspc
Yammer JavaScript SDKAuthenticationWraps authentication for you
Login with Yammer button
Requests/ActionsHelpers for requests to Yammer
<script type="text/javascript" data-app-id="[APP CLIENTID]" src="https://assets.yammer.com/platform/yam.js"></script>
OpenGraphActor, Action, Object using JSON payload
#auspc #nzspc
Tips Watch out for CORS Old API’s
#auspc #nzspc
Demo
Rest API
#auspc #nzspc
#auspc #nzspc
#auspc #nzspc
#auspc #nzspc
.
#auspc #nzspc
#auspc #nzspc
Demo
REST API
#auspc #nzspc
Considerations Throttling (rate) limits
Autocomplete: 10 requests in 10 seconds. Messages: 10 requests in 30 seconds. Notifications: 10 requests in 30 seconds. All Other Resources: 10 requests in 10 seconds.
Designed to run as the current user – HTTPCONTEXTArticle : information on impersonation .NET app, impersonation, token~ run with scissors elevated privileges
#auspc #nzspc
Summary What’s available OOB Authentication Embed Rest API
Questions & Answers
Come and see Elaine + Chris at the OBS stand Prize draw
#auspc #nzspc
Thank you to our sponsors