Cozy cozy-konnector-facebook
Cozy is a platform that brings all your web services in the same private space. With it, your webapps and your devices can share data easily, providing you with a new experience. You can install Cozy on your own hardware where no one's tracking you.
This konnector let you import your facebook images.
If you want to work on this konnector and submit code modifications, feel free to open pull-requests! See the contributing guide for more information about how to properly open pull-requests.
This connector uses cozy-konnector-libs. You can find more documentation about it there.
As we need to generate a facebook OAuth2 token, we need a CLIENT_ID
and CLIENT_SECRET
. You can find these pieces of information by going to the Facebook for developers page, clicking your project --> Parameters --> General.
Once acquired, fill the keys.json file.
To configure the konnector, you can edit ./konnector-dev-config.json
with the following:
{
"COZY_URL": "http://cozy.tools:8080",
"fields": {
"access_token": <ACCESS_TOKEN>,
"refresh_token": <REFRESH_TOKEN>
}
}
To help you fill this file, you can run yarn token
, it will help you generate a new access_token
.
(This token will be stored in ~/.config/configStore/cozy-konnector-facebook.json
, and you can reset a new token with
yarn token --reset
).
If you just want to test this connector without any cozy available.
You first need an installed nodejs (LTS version is fine).
And the last version of yarn :
npm install --global yarn
Then just run :
yarn
yarn standalone
The requests to the cozy-stack will be stubbed using the [./fixture.json] file as source of data and when cozy-client is asked to create or update data, the data will be output to the console. The bills (or any file) will be saved in the . directory.
If you do not want to have to install the konnector on a cozy v3 to test it, you can register the konnector as an OAuth application with the following commands :
yarn
yarn dev
This command will register your konnector as an OAuth application to the cozy-stack. By default, the cozy-stack is supposed to be located in http://cozy.tools:8080. If this is not your case, just update the COZY_URL field in [./konnector-dev-config.json].
After that, your konnector is running but should not work since you did not specify any credentials to the target service. You can do this also in [./konnector-dev-config.json] in the "fields" attribute.
Now run yarn dev
one more time, it should be ok.
The files are saved in the root directory of your cozy by default.
client_id
, client_secret
, auth_endpoint
, token_endpoint
, grant_mode
and redirect_uri
to your stack, see https://github.com/cozy/cozy-stack/blob/master/docs/account_types.md#facebook
To setup and run a konnector, Cozy provides a web application called cozy-collect
.
Then you'll have to register the konnector's oauth system into the cozy-stack's server with the following (see it on cozy/cozy-stack):
curl -X PUT 'localhost:5984/secrets%2Fio-cozy-account_types'
curl -X PUT localhost:5984/secrets%2Fio-cozy-account_types/facebook -d '{ "grant_mode": "authorization_code", "client_id": "<CLIENT_ID>", "client_secret": "<CLIENT_SECRET>", "auth_endpoint": "https://www.facebook.com/v2.3/dialog/oauth", "token_endpoint": "https://graph.facebook.com/2.12/oauth2/access_token" }'
Finally, you'll need to register the correct redirect_uri
to the Facebook application page.
http://cozy.tools:8080/accounts/facebook/redirect
Where cozy.tools:8080
is the url to join the cozy-stack's server.
To debug or try the konnector with a local build, you'll need to update the konnector with:
./cozy-stack konnectors update facebook file://$PWD/../cozy-konnector-facebook/build
~/.cozy/cozy.yaml
and add the following configuration:
konnectors:
cmd: <path_to_your_cozy-stack>/cozy-stack/scripts/konnector-node-run.sh
The cozy-stack runs the connector in a nsjail container to be sure it does not affect the environment.
The connector is run by calling yarn start with the following envrionment variables :
- COZY_CREDENTIALS needs to be the result of
cozy-stack instances token-cli <instance name> <scope>
- COZY_URL is the full http or https url to your cozy
- COZY_FIELDS is something like :
{
"data":{
"attributes":{
"arguments":{
"account":"cf31eaef5d899404a7e8c3737c1c2d1f",
"folder_to_save":"folderPathId",
"slug":"mykonnector"
}
}
}
}
The "account" field is the id of the record with doctype "io.cozy.accounts" which will be used as parameters for your konnector.
To be able to run the connector, the cozy stack needs a connector which is built into only one file, without needing to install its dependencies, this will be a lot faster to install.
There is a command in package.json to help you to do that : yarn build
This command uses webpack to bundle all the code needed by your connector into one file.
This will generate an index.js file in the build directory and add all files the connector will need.
You can deploy this build by using the specific script : yarn deploy
This command will commit and push your build in the branch build
fo your project.
And your konnector can now be installed using the following url :
git://github.com/konnectors/cozy-konnector-facebook.git#build
This project contains a .travis.yml
config file which allows you to build your connector
automatically using Travis-CI.
You can follow these steps to enable building using Travis:
- On your travis-ci.org account, find your project name (should be the same than your Github repository) and enable Travis by using the related checkbox.
- Once enabled, go to this project on Travis by clicking on it and go to the "Settings" menu by using the "More options" menu at the top right.
- Enable these three options:
- "Build only if .travis.yml is present"
- "Build branch updates" (run Travis after each branch update)
- "Build pull request updates" (run Travis after each Pull Request update)
- Then, you have to generate a Github token in your Github account settings. Here is the Github blog post about API token. Don't forget to authorize the access to the repo scope like following:
- Then, add an environment variable (still in your Travis project settings) named
GITHUB_TOKEN
and use your previous generated Github token as value (We highly recommand you to keep the checkbox "Display value in build log" to OFF value in order to keep your token value hidden in the Travis logs.)
Now Travis is ready to build your project, it should build it each time your push a commit in your repository or create a pull request.
Note: Travis will push your build to your
build
branch ONLY for commits made on your master branch (included PR merge commits). You can see the related Travis statement here.
Add your new connector to Cozy Collect
The Cozy Collect application will soon use an application store as source of connectors. But for now, if you want to add your new connector to Cozy Collect, you can submit a message in the forum in the collect section, and we will handle this for you.
We use standard to format the index.js
file. You can run it with:
yarn lint
The lead maintainers for this konnector is
You can reach the Cozy Community by:
- Chatting with us on IRC #cozycloud on Libera.Chat
- Posting on our Forum
- Posting issues on the Github repos
- Say Hi! on Twitter
is developed by and distributed under the AGPL v3 license.