{"id":20777765,"url":"https://github.com/fiware/node-red-contrib-fiware_official","last_synced_at":"2025-04-30T18:41:39.144Z","repository":{"id":40215823,"uuid":"176566083","full_name":"FIWARE/node-red-contrib-FIWARE_official","owner":"FIWARE","description":"FIWARE-Node-Red integration supporting NGSI-LD","archived":false,"fork":false,"pushed_at":"2023-01-23T22:26:12.000Z","size":503,"stargazers_count":14,"open_issues_count":10,"forks_count":9,"subscribers_count":12,"default_branch":"master","last_synced_at":"2024-11-16T14:36:19.168Z","etag":null,"topics":["agriculture","cim","city","context","data","engineering","etsi","fiware","industry","information","integration","iot","isg","ngsi","ngsi-ld","node-red","processing","programming","smart","visual"],"latest_commit_sha":null,"homepage":"https://nodered.org/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/FIWARE.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-03-19T17:34:33.000Z","updated_at":"2024-04-15T11:52:42.000Z","dependencies_parsed_at":"2023-01-31T12:15:41.906Z","dependency_job_id":null,"html_url":"https://github.com/FIWARE/node-red-contrib-FIWARE_official","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FIWARE%2Fnode-red-contrib-FIWARE_official","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FIWARE%2Fnode-red-contrib-FIWARE_official/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FIWARE%2Fnode-red-contrib-FIWARE_official/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FIWARE%2Fnode-red-contrib-FIWARE_official/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FIWARE","download_url":"https://codeload.github.com/FIWARE/node-red-contrib-FIWARE_official/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225040403,"owners_count":17411481,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agriculture","cim","city","context","data","engineering","etsi","fiware","industry","information","integration","iot","isg","ngsi","ngsi-ld","node-red","processing","programming","smart","visual"],"created_at":"2024-11-17T13:17:02.620Z","updated_at":"2024-11-17T13:17:03.292Z","avatar_url":"https://github.com/FIWARE.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# node-red-contrib-FIWARE_official\n\nOfficial Node-RED FIWARE integration\n\n[![License badge](https://img.shields.io/github/license/FIWARE/node-red-contrib-FIWARE_official.svg)](https://opensource.org/licenses/Apache-2.0)\n[![NGSI v2](https://img.shields.io/badge/NGSI-v2-5dc0cf.svg)](https://fiware-ges.github.io/orion/api/v2/stable/)\n[![NGSI LD](https://img.shields.io/badge/NGSI-LD-d6604d.svg)](https://www.etsi.org/deliver/etsi_gs/CIM/001_099/009/01.03.01_60/gs_cim009v010301p.pdf)\n\u003cbr\u003e\n![CI](https://github.com/FIWARE/node-red-contrib-FIWARE_official/workflows/CI/badge.svg)\n\nSupported Nodes:\n\n* NGSI(v2,LD) Entity\n* NGSI(v2,LD) Dataset\n* NGSI(v2,LD) Update\n* NGSI(v2,LD) Subscription\n* NGSI(v2) v2ToLD\n\n## How to install\n\nYou can install this module into an environment running Node-RED by running one of the following commands:\n\n```console\nnpm install node-red-contrib-fiware_official\n```\n\nor\n\n```console\nnpm install https://github.com/FIWARE/node-red-contrib-FIWARE_official.git#master\n```\n\n## How to run Node-RED and Orion Context Broker with Docker\n\nPlease clone the repository. Create the necessary images and start up a series of containers by running the commands\nas shown below:\n\n```console\ngit clone https://github.com/FIWARE/node-red-contrib-FIWARE_official.git\ncd node-red-contrib-FIWARE_official/docker\ndocker-compose up -d\n```\n\nOnce the containers have started, Open the portal page of Node-READ on `http://{ip address of your machine}:1880/`.\n\n\u003e :information_source: **Note:** Everything you do with Node-RED and Orion Context Broker when dockerized is\n\u003e non-persistent. You will lose all your data if you turn off the containers. \n\n## Securing Node-RED with Keyrock\n\nYou can protect the Node-RED editor and admin API with [Keyrock](https://github.com/ging/fiware-idm)\nand [Passport-FIWARE-OAuth](https://github.com/conwetlab/passport-fiware-oauth).\nRegister node-red as an application in Keyrock and get `clientID` and `clientSecret`.\nThen, Add the following config to `setting.js`. You should change `serverURL`, `clientID`, `clientSecret` and\n`callbackURL` to suit your system environment. Please See http://nodered.org/docs/security.html for details\nabout `setting.js`.\n\n```console\nadminAuth: {\n    type:\"strategy\",\n    strategy: {\n        name: \"fiware\",\n        label: 'Sign in with Keyrock',\n        strategy: require(\"passport-fiware-oauth\").OAuth2Strategy,\n        options: {\n            serverURL: \"https://keyrock\",\n            clientID: \"00000000-0000-0000-0000-000000000000\",\n            clientSecret: \"00000000-0000-0000-0000-000000000000\",\n            callbackURL: \"https://node-red/auth/strategy/callback\",\n            isLegacy: false,\n            verify: function(accessToken, refreshToken, profile, done) {\n              // console.log(profile);\n              done(null, profile._json);\n            },\n            state: true\n        }\n    },\n    users: [\n       { username: \"admin\",permissions: [\"*\"]}\n    ]\n},\n```\n\n\u003e :information_source: **Note:** This configuration was verified in a environment installed Node-RED 1.2.9, Keyrock\n\u003e 7.8 and Passport-FIWARE-OAuth 0.3.0.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffiware%2Fnode-red-contrib-fiware_official","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffiware%2Fnode-red-contrib-fiware_official","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffiware%2Fnode-red-contrib-fiware_official/lists"}