Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/PerfectExamples/Perfect-Authentication-Demo
OAuth2 Demo
https://github.com/PerfectExamples/Perfect-Authentication-Demo
authentication facebook github google linkedin oauth2 perfect salesforce server-side-swift swift
Last synced: 2 months ago
JSON representation
OAuth2 Demo
- Host: GitHub
- URL: https://github.com/PerfectExamples/Perfect-Authentication-Demo
- Owner: PerfectExamples
- License: apache-2.0
- Created: 2017-01-25T21:33:38.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2018-05-07T14:44:52.000Z (over 6 years ago)
- Last Synced: 2024-08-02T00:22:34.745Z (5 months ago)
- Topics: authentication, facebook, github, google, linkedin, oauth2, perfect, salesforce, server-side-swift, swift
- Language: CSS
- Homepage: https://github.com/PerfectlySoft/Perfect-Authentication
- Size: 1.56 MB
- Stars: 12
- Watchers: 4
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- Awesome-Swift-Packages - Perfect-Authentication-Demo - OAuth2 Demo. (Samples)
README
# Perfect-Authentication Demo
[](http://perfect.org/get-involved.html)
[](https://github.com/PerfectlySoft/Perfect)
[](https://gitter.im/PerfectlySoft/Perfect)
[](https://twitter.com/perfectlysoft)
[](http://perfect.ly)
[](https://developer.apple.com/swift/)
[](https://developer.apple.com/swift/)
[](http://perfect.org/licensing.html)
[](http://twitter.com/PerfectlySoft)
[](https://gitter.im/PerfectlySoft/Perfect?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[](http://perfect.ly) [](https://badge.fury.io/gh/PerfectlySoft%2FPerfect-CURL)
## Demonstrating the OAuth2 Library for Perfect
This project provides [OAuth2](https://oauth.net/2/) demo of the [Perfect Authentication](https://github.com/PerfectlySoft/Perfect-Authentication) libraries and select OAuth2 provider drivers - Facebook, Google, GitHub.
Full documentation can be found at [http://www.perfect.org/docs/OAuth2.html](http://www.perfect.org/docs/OAuth2.html)
This package builds with Swift Package Manager and is part of the [Perfect](https://github.com/PerfectlySoft/Perfect) project. It was written to be stand-alone and so does not require PerfectLib or any other components.
Ensure you have installed and activated the latest Swift 3.0 tool chain.
## Setup
Download this repo, clone it, or import it using [Perfect Assistant](https://www.perfect.org/en/assistant/). Build, configure the system with your AppID's and secrets, and run.
```
git clone https://github.com/PerfectExamples/Perfect-Authentication-Demo
cd Perfect-Authentication-Demo
swift build
.build/debug/Perfect-Authentication-Demo
```
Alternatively, build the Xcode project with `swift package generate-xcodeproj`.
If you choose to generate an Xcode Project, you MUST change to the executable target AND set the custom working directory to the project directory for its scheme in order for the web routes to work properly.
## Configuration
Each provider needs an "appid", also known as a "key", and a "secret". These are usually generated by the OAuth Host, such as Facebook, GitHub and Google developer consoles. These values, as well as an "endpointAfterAuth" and "redirectAfterAuth" value must be set for each provider you wish to use. If you leave any unset, the authentication will fail.
These settings are configured by removing the ".default" extension from the "ApplicationConfiguration.json.default" file in the "config" directory, then populating the values as needed.
The default file looks like this:
``` swift
{
"facebookAppID": "---",
"facebookSecret": "---",
"facebookEndpointAfterAuth": "http://localhost:8181/auth/response/facebook",
"facebookRedirectAfterAuth":"http://localhost:8181/",
"githubKey": "---",
"githubSecret": "---",
"githubEndpointAfterAuth": "http://localhost:8181/auth/response/github",
"githubRedirectAfterAuth":"http://localhost:8181/",
"googleKey": "---",
"googleSecret": "---",
"googleEndpointAfterAuth": "http://localhost:8181/auth/response/google",
"googleRedirectAfterAuth":"http://localhost:8181/"
}
```
Replace the `---` values with those from your own accounts.
## Running
Once the demo has been configured, it can be run from the command line, or from Xcode.
It can then be accessed from a web browser at `http://localhost:8181`.
The first page you will see will have the following:
```
SessionID: <>
Login Type:
UserID:
UserName:
Picture:
AccessToken:
```
These values however will be populated upon login with one of the providers via the buttons.
Logging out will terminate the session, and start a new session without any information gained from a login with a provider.
Note that this demo uses the "MemorySessions" driver, so terminating the demo and restarting it will delete all existing sessions.
## Further Information
For more information on the Perfect project, please visit [perfect.org](http://perfect.org).