Merge Stable into Master

CHANGELOG.md

@@ -1,3 +1,23 @@
+# Version 1.6.00
+
+### Bug fixes
+- `MASAuthCredentialsJWT` credentials was marked as re-usable, so the Mobile SDK tried to consume the same credentials for a certain period of time. JWT credentials can now be consumed only one time, and is not reusable. [DE324462]
+- Device deregistration was removing all credentials from the Mobile SDK regardless of the result of deregistration request.  Now, the Mobile SDK removes credentials only when the deregistration request succeeds. [DE324142]
+- Mobile SDK was changing `MASGrantFlow` to client credentials in a specific scenario with Cordova SDK. The Mobile SDK no longer switches the `MASGrantFlow` by itself. [DE311841]
+- Mobile SDK enhances the device registration flow so it handles the device registration record more smoothly. This removes the hassle of developers seeing "This device has already been registered and has not been configured to accept updates" error message in development phase. [US406920]
+- `MASConfiguration` was not properly updating the updated endpoint values when switching to a different configuration. It is fixed. [DE321925]
+- `MASConfiguration` had some hard-coded values for client credentials device registration endpoint. `MASConfiguration` now reads the value from the configuration. [DE321921]
+- `MASMQTTClient` was unable to reestablish MQTT connection when the user session was logged out, and logged in with a different account. Mobile SDK now properly handles session changes for MQTT connection. [US408725]
+- Mobile SDK now stores all credentials only to the device. Data will not be backed-up or transferred with iCloud unless `[MAS setKeychainSynchroizable:]` is explicitly set to `YES`. [US388853]
+- Mobile SDK's MQTT connection was unable to establish mutual SSL connection with public CA certificate. The Mobile SDK now establishes mutual SSL with public CA certificate when **entire certificate chain** is exported in JSON configuration. [US399506]
+
+### New features
+- Mobile SDK introduces a secure way of storing and sharing data across multiple applications using same keychain sharing group with MASFoundation's `MASSharedStorage` class. [US416558]
+- Mobile SDK introduces a new way of building API CRUD request with `MASRequestBuilder` and `MASRequest` classes to provide seamless developer experience Android SDK. [US374082]
+
+### Deprecated methods
+- `[MASConfiguration setSecurityConfiguration:]` is deprecated.  Please use `[MASSecurityConfiguration setSecurityConfiguration:error:]` for better handling of error cases when setting the security configuration object. [DE328373]
+
 # Version 1.5.00
 
 NOTE: From this version on the frameworks changed to Dynamic instead of Static library
@@ -12,14 +32,14 @@ NOTE: From this version on the frameworks changed to Dynamic instead of Static l
 - The SDK no longer requires Keychain Sharing to be enabled in Xcode. However, to establish SSO across multiple applications, Keychain Sharing must be enabled. [US320771]
 - Mobile SDK now only validates against the leaf certificate for SSL pinning validation by default. The configuration can be changed to validate against entire certificate chain through `MASSecurityConfiguration`. [US374086]
 
-### New Features
+### New features
 - Mobile SDK introduces an ability to configure security configuration for external APIs (such as SSL pinning), so that Mobile SDK can securely connect to external API (other than primary Gateway). [US344780]
 - The SDK handles multiple concurrent API requests with proper authentication processes. [US362800]
 - The SDK supports dynamic framework. All you need to do is update your Xcode settings. [US367604]
 - The SDK introduces more flexible and extensible authentication with different types of credentials. For details, see `MASAuthCredentials`. [US349497]
 - The SDK introduces the ability to digitally sign the request as JWT. See `MASClaims` to sign the request. [US313137]
 
-### Deprecated Methods
+### Deprecated methods
 - `[MAS setUserLoginBlock:]` is deprecated.  Please use `[MAS setAuthCredentials:]` block to perform implicit authentication with `MASAuthCredentials` object.
 
 

CONTRIBUTING.md

@@ -1,11 +1,11 @@
-# Contribute to CA Mobile App Services SDK
+# Contribute to iOS Mobile SDK
 Contributions are welcome and much appreciated. Just follow these easy steps to contribute.
 
 ## Code Standard and Guideline
-For consistency, we ask that you adhere to some basic code guidelines when contributing to the MAS SDK. See the [Code Standard and Guideline][guidelines] for details.
+For consistency, we ask that you adhere to some basic code guidelines when contributing to the iOS Mobile SDK. See the [Code Standard and Guideline][guidelines] for details.
 
 ## Our Development Process
-To continue improving the SDK, the MAS development team will work on the same GitHub repos as you. The `develop branch` is used for development, and the `master branch` is used only for stable releases.
+To continue improving the SDK, our development team will work on the same GitHub repos as you. The `develop branch` is used for development, and the `master branch` is used only for stable releases.
 **Note:** For production environments, please use releases only from the master branch.
 
 ### Pull Requests
@@ -14,7 +14,7 @@ We welcome and encourage pull requests. When we get a pull request, it is peer r
 Follow these steps for pull requests:
 
 1. Fork the repo and create your branch from `master`.
-4. For any new code, add unit tests.
+2. For any new code, add unit tests.
 3. If you've changed APIs, update code comments for AppleDocs.
 4. Verify that the test suite passes.
 5. Verify that your code follows the [Code Standard Guideline][guidelines]
@@ -44,12 +44,12 @@ Before filing a new issue, check Known Issues to see if your problem already exi
 * Anything else that seems relevant. 
 
 ## License
-By contributing to CA Mobile App Services SDK, you agree that your contributions will be licensed under its [license][license-link].
+By contributing to iOS Mobile SDK, you agree that your contributions will be licensed under its [license][license-link].
 
 
- [guidelines]: /GUIDELINES.md
- [community]: https://communities.ca.com/community/ca-api-management-community/content?filterID=contentstatus%5Bpublished%5D~category%5Bca-mobile-api-gateway%5D
- [license-link]: /LICENSE
- [cla]: https://www.clahub.com/agreements/CAAPIM/iOS-MAS-Foundation
- [casupport]: https://support.ca.com/irj/portal/implsvcnewcase
- 
+[guidelines]: /GUIDELINES.md
+[community]: https://communities.ca.com/community/ca-api-management-community/content?filterID=contentstatus%5Bpublished%5D~category%5Bca-mobile-api-gateway%5D
+[license-link]: /LICENSE
+[cla]: https://www.clahub.com/agreements/CAAPIM/iOS-MAS-Foundation
+[casupport]: https://support.ca.com/irj/portal/implsvcnewcase
+

GUIDELINES.md

@@ -1,29 +1,27 @@
-# CA Technologies Mobile App Services Objective-C Style Guide
+# CA Technologies Objective-C Style Guide
 
-This document describes the Objective-C coding style of iOS team for CA Technologies Mobile App Services.  This guideline is recommended to comply with all Objective-C implementations of our products.
+This document describes the Objective-C coding style of the iOS Mobile SDK team.  This guideline is recommended to comply with all Objective-C implementations of our products.
 
-## Review Apple's Official Coding Guideline
+## Review Apple Official Coding Guideline
 
-Beyond the guidelines defined in this document, we also recommend reviewing Apple's official coding guidelines.  
+Beyond the guidelines defined in this document, we also recommend reviewing the Apple official coding guidelines.  
 
 * [Programming with Objective-C](http://developer.apple.com/library/mac/#documentation/Cocoa/Conceptual/ObjectiveC/Introduction/introObjectiveC.html)
 * [Cocoa Fundamentals Guide](https://developer.apple.com/library/mac/#documentation/Cocoa/Conceptual/CocoaFundamentals/Introduction/Introduction.html)
 * [Coding Guidelines for Cocoa](https://developer.apple.com/library/mac/#documentation/Cocoa/Conceptual/CodingGuidelines/CodingGuidelines.html)
 * [App Programming Guide for iOS](http://developer.apple.com/library/ios/#documentation/iphone/conceptual/iphoneosprogrammingguide/Introduction/Introduction.html)
 
-### MAS Products
+### iOS Mobile SDK
 
-For more information about MAS, see [Mobile App Service developer](http://mas.ca.com).
-
-Mobile App Services consists of multiple functional products separated into individual frameworks.
+The iOS Mobile SDK consists these frameworks.
 
 * MASFoundation
 * MASUI
 * MASConnecta
 * MASIdentityManagement
 * MASStorage
 
-All of frameworks are recommended to comply with the coding guideline.
+All of frameworks are recommended to comply with the coding guideline. For more information about the iOS Mobile SDK, see [developer website](http://mas.ca.com).
 
 ## Table of Contents
 
@@ -346,7 +344,7 @@ typedef NS_ENUM(NSInteger, MASRequestResponseType)
 + (MASObject *)currentObject;
 
 - (void)setObject:(id)object forKeyedSubscript:(id <NSCopying>)key;
-``` 
+```
 
 **Not:**
 
@@ -356,7 +354,7 @@ typedef NS_ENUM(NSInteger, MASRequestResponseType)
 +(MASObject*)currentObject;
 
 -(void)setObject:(id)object forKeyedSubscript:(id<NSCopying>)key;
-``` 
+```
 
 #### Newline