Refocus
QuickStart guide!
Get started now with our
Refocus is a platform for visualizing the health and status of systems and/or services under observation. Check out our home page and our docs.
- Features
- Quickstart
- Perspective Debugging
- API Documentation
- Securing Refocus
- Useful Resources
- Contributing
Features
- API for everything
- Pluggable lenses
- Self-service
- Easy deployment to Heroku
Quickstart
See the Quickstart guide to get going with Refocus!
Securing Refocus
- After installation, log in (UI or API) as
[email protected]
with passwordpassword
and change the password for that account. - Create a new user record for yourself with your real email address, and set your profile to the
Admin
profile. - If you want to restrict access to specific IP ranges, see IP Restrictions below.
- If you want to use your own single sign-on (SSO) user authentication service, see Authentication below.
- Invite other users. Note: by default, only users with the
Admin
profile will be able to invite other users. If you want to let users register themselves as Refocus users, an Admin must set the config parameterSELF_REGISTRATION_ENABLED
totrue
.
IP Restrictions
By default, there are no IP restrictions for Refocus access. An admin can configure IP restrictions by adding a config var in Heroku with name IP_WHITELIST
and value array of IP ranges, eg. [ [1.2.3.4, 1.2.3.8], [7.6.5.4, 7.6.9.9], [8.8.8.8, 9.9.9.9] ]
. Only the specified IP ranges will be allowed access to Refocus.
Authentication
Local Authentication only. SSO is not enabled.
A user should sign up with Refocus using register page or POST to /v1/register. Once registered, the user can sign in using Local authentication - username/password on Refocus login page.
SSO enabled with Local authentication.
Non-SSO users
Non-SSO users should authenticate with Refocus as described above using Local Authentication.
SSO-Users
If Single Sign On (SSO) is configured in Refocus, SSO users can login using 'SSO Login' button on login page. In case of local authentication with username/password, SSO users will be considered as unregistered user unless they sign up using register page or POST to /v1/register. Once an SSO user is registered with SSO username, the user can sign in using local authentication as well.
Using API Access Tokens
See docs.
Perspective Debugging
If you are troubleshooting realtime event handling in a perspective, add query parameter debug=REALTIME
to any perspective URL. This turns on console logging in the browser for all the realtime subject and sample events the perspective receives.
API Documentation
The API is self-documenting based on ./api/v1/swagger.yaml
. Start your server and open MY_HOST:MY_PORT/v1/docs
for interactive documentation of all the Refocus API endpoints.
Useful Resources
- Redis command line interface
- Postman for testing API calls
- Node.js token-based authentication
Contributing
Guidelines on contributing to Refocus are available here.