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