Use Microsoft Graph to access a user’s Microsoft account data from within an iOS app written in Objective C. This sample uses the Microsoft Graph Client Library to work with the data, and allows you to authenticate using work, school, and personal accounts.
Objective-C HTML Ruby
Latest commit 065a2f2 Oct 15, 2016 @unpluggedk unpluggedk committed on GitHub Merge pull request #5 from v-dobr/master
HB 20160906

ReadMe.md

Office 365 Connect Sample for iOS Using the Microsoft Graph SDK

Microsoft Graph is a unified endpoint for accessing data, relationships and insights that come from the Microsoft Cloud. This sample shows how to connect and authenticate to it, and then call mail and user APIs through the Microsoft Graph SDK for iOS.

Note: Try out the Microsoft Graph App Registration Portal page which simplifies registration so you can get this sample running faster.

Prerequisites

  • Download Xcode from Apple.

  • Installation of CocoaPods as a dependency manager.

  • A Microsoft work or personal email account such as Office 365, or outlook.com, hotmail.com, etc. You can sign up for an Office 365 Developer subscription that includes the resources that you need to start building Office 365 apps.

    Note: If you already have a subscription, the previous link sends you to a page with the message Sorry, you can’t add that to your current account. In that case, use an account from your current Office 365 subscription.

  • A client id from the registered app at Microsoft Graph App Registration Portal
  • To make requests, an MSAuthenticationProvider must be provided which is capable of authenticating HTTPS requests with an appropriate OAuth 2.0 bearer token. We will be using msgraph-sdk-ios-nxoauth2-adapter for a sample implementation of MSAuthenticationProvider that can be used to jump-start your project. See the below section Code of Interest for more information.

Running this sample in Xcode

  1. Clone this repository
  2. If it is not already installed, run the following commands from the Terminal app to install and set up the CocoaPods dependency manager.

    sudo gem install cocoapods
    
    pod setup
    
  3. Use CocoaPods to import the Microsoft Graph SDK and authentication dependencies:

    pod 'MSGraphSDK'
    pod 'MSGraphSDK-NXOAuth2Adapter'
    

    This sample app already contains a podfile that will get the pods into the project. Simply navigate to the project root where the podfile is and from Terminal run:

      pod install
    

    For more information, see Using CocoaPods in Additional Resources

  4. Open O365-iOS-Microsoft-Graph-SDK.xcworkspace

  5. Open AuthenticationConstants.m. You'll see that the ClientID from the registration process can be added to the top of the file.:

    // You will set your application's clientId
    NSString * const kClientId    = @"ENTER_YOUR_CLIENT_ID";
    

    Note: You'll notice that the following permission scopes have been configured for this project: "https://graph.microsoft.com/Mail.Send", "https://graph.microsoft.com/User.Read", "offline_access". The service calls used in this project, sending a mail to your mail account and retrieving some profile information (Display Name, Email Address) require these permissions for the app to run properly.

  6. Run the sample. You'll be asked to connect/authenticate to a work or personal mail account, and then you can send a mail to that account, or to another selected email account.

Code of Interest

All authentication code can be viewed in the AuthenticationProvider.m file. We use a sample implementation of MSAuthenticationProvider extended from NXOAuth2Client to provide login support for registered native apps, automatic refreshing of access tokens, and logout functionality:

    [[NXOAuth2AuthenticationProvider sharedAuthProvider] loginWithViewController:nil completion:^(NSError *error) {
        if (!error) {
        [MSGraphClient setAuthenticationProvider:[NXOAuth2AuthenticationProvider sharedAuthProvider]];
        self.client = [MSGraphClient client];
         }
    }];

Once the authentication provider is set, we can create and initialize a client object (MSGraphClient) that will be used to make calls against the Microsoft Graph service endpoint (mail and users). In SendMailViewcontroller.m we can assemble a mail request and send it using the following code:

MSGraphUserSendMailRequestBuilder *requestBuilder = [[self.client me]sendMailWithMessage:message saveToSentItems:true];    
MSGraphUserSendMailRequest *mailRequest = [requestBuilder request];   
[mailRequest executeWithCompletion:^(NSDictionary *response, NSError *error) {      
}];

For more information, including code to call into other services like OneDrive, see the Microsoft Graph SDK for iOS

Questions and comments

We'd love to get your feedback about the Office 365 iOS Microsoft Graph Connect project. You can send your questions and suggestions to us in the Issues section of this repository.

Questions about Office 365 development in general should be posted to Stack Overflow. Make sure that your questions or comments are tagged with [Office365] and [MicrosoftGraph].

Contributing

You will need to sign a Contributor License Agreement before submitting your pull request. To complete the Contributor License Agreement (CLA), you will need to submit a request via the form and then electronically sign the CLA when you receive the email containing the link to the document.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

Additional resources

Copyright

Copyright (c) 2016 Microsoft. All rights reserved.