OAuth and the Aras RESTful API
This project provides a sample .NET Core console application that demonstrates how to use the Aras Innovator OAuth server with the Aras RESTful API.
Note: This sample application is not intended to be used as-is. Its purpose is to provide sample code that can be tested and adapted for an actual use case. Future releases of this project may include a sample with a client GUI. If you're looking for a client implemented with a specific framework or language, file an enhancement issue on this repo and we'll check it out.
|v1.0.0||First release. Tested on Aras 11 SP15.|
Supported Aras Versions
|v1.0.0||11.0 SP14, 11.0 SP15|
Always back up your code tree and database before applying an import package or code tree patch!
- Aras Innovator installed
- .NET Core installed
Build the Console Application
ConsoleApp\ODataExample.slnin Visual Studio.
- Select Program.cs from the Solution Explorer.
- Update the constants with credentials for your Aras Innovator instance:
const string innovatorUrl = "http://localhost/InnovatorServer"; // base Innovator url const string innovatorUsername = "admin"; // Innovator user name const string innovatorPassword = "607920B64FE136F9AB2389E371852AF2"; // MD5 hash of Innovator user password const string innovatorDatabase = "InnovatorSolutions"; // database name const string oauthServerClientId = "IOMApp"; // must be registered in authorization server's oauth.config file
Note: the oauthServerClientId must be registered in the authorization server's
OAuthServer\OAuth.configfile. The IOMApp is registered by default, so you don't need to change this value unless you want to add a custom application.
- Save your changes to Program.cs.
- From the Build menu, select Build ODataExample.
Once build has executed, you can find the resulting dll in
This sample application is not intended to be used as-is. Its purpose is to provide sample code that can be tested and adapted for an actual use case. However, here are some steps for testing the built dll and confirming the REST request succeeds.
- Open a command prompt window.
- Navigate to the location of the ODataExample.dll file (
The result of the REST call will be printed to the command prompt window.
- Fork it!
- Create your feature branch:
git checkout -b my-new-feature
- Commit your changes:
git commit -am 'Add some feature'
- Push to the branch:
git push origin my-new-feature
- Submit a pull request
For more information on contributing to this project, another Aras Labs project, or any Aras Community project, shoot us an email at firstname.lastname@example.org.
Created by Aras Development.
- Eli Donahue, Aras Labs @EliJDonahue
Aras Labs projects are published to Github under the MIT license. See the LICENSE file for license rights and limitations.)