# cloudflash-ffproxy

> cloudflash-ffproxy module implements ffproxy configuration on cloudflash enabled devices

Latest version **1.3.4** (published 2014-03-04) · 0 weekly downloads

## Install

```sh
npm install cloudflash-ffproxy
pnpm add cloudflash-ffproxy
yarn add cloudflash-ffproxy
bun add cloudflash-ffproxy
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.3.4 |
| Published | 2014-03-04 |
| First published | 2013-03-01 |
| Weekly downloads | 0 |
| TypeScript types | none |
| Module format | CommonJS |
| Node | 0.6.x |
| Dependencies | 4 |
| Known vulnerabilities | 0 (+2 in 2 direct dependencies) |
| Install scripts | no |
| Author | Geetha Rani |
| Maintainers | clearpath |

## Links

- npm: https://www.npmjs.com/package/cloudflash-ffproxy
- Repository: https://github.com/clearpath-networks/cloudflash-ffproxy
- Issues: https://github.com/clearpath-networks/cloudflash-ffproxy/issues
- npm.io page: https://npm.io/package/cloudflash-ffproxy

## Dependencies (4)

- [dirty](https://npm.io/package/dirty.md) 0.9.x
- [fileops](https://npm.io/package/fileops.md) 0.1.3
- [node-uuid](https://npm.io/package/node-uuid.md) 1.3.x
- [json-schema](https://npm.io/package/json-schema.md) 0.2.0

## Recent versions

- 1.3.4 (latest) — 2014-03-04
- 1.3.3 — 2014-03-03
- 1.3.2 — 2014-03-02
- 1.3.1 — 2014-03-01
- 1.2.9 — 2014-02-28
- 1.2.8 — 2013-11-19
- 1.2.7 — 2013-09-12
- 1.2.6 — 2013-07-29
- 1.2.5 — 2013-07-11
- 1.2.4 — 2013-05-31
- 1.2.3 — 2013-03-16
- 1.2.2 — 2013-03-15
- 1.2.1 — 2013-03-13
- 1.2.0 — 2013-03-13
- 1.1.9 — 2013-03-13
- … 10 more at https://npm.io/package/cloudflash-ffproxy/versions

## README

cloudflash-ffproxy
==================

*List of ffproxy APIs*
========================

<table>
  <tr>
    <th>Verb</th><th>URI</th><th>Description</th>
  </tr>
  <tr>
    <td>POST</td><td>/ffproxy/policy</td><td>To create ffproxy policy configuration</td>
  </tr>
  <tr>
    <td>GET</td><td>/ffproxy/policy</td><td>List summary of ffproxy policy configuration</td>
  </tr>
  <tr>
    <td>GET</td><td>/ffproxy/policy/:id</td><td>List summary of ffproxy policy configuration by ID</td>
  </tr>
  <tr>
    <td>PUT</td><td>/ffproxy/policy/:id</td><td>Update existing ffproxy policy configuration in VCG/CPEs by ID</td>
  </tr>
  <tr>
    <td>DELETE</td><td>/ffproxy/policy/:id</td><td>To delete existing ffproxy policy configuration by ID</td>
  </tr>

  <tr>
    <td>POST</td><td>/ffproxy/categories</td><td>To create ffproxy categories configuration</td>
  </tr>
  <tr>
    <td>GET</td><td>/ffproxy/categories</td><td>List summary of ffproxy categories configuration</td>
  </tr>
  <tr>
    <td>GET</td><td>/ffproxy/categories/:id</td><td>List summary of ffproxy categories configuration by ID</td>
  </tr>
  <tr>
    <td>PUT</td><td>/ffproxy/categories/:id</td><td>Update existing ffproxy categories configuration in VCG/CPEs by ID</td>
  </tr>
  <tr>
    <td>DELETE</td><td>/ffproxy/categories/:id</td><td>To delete existing ffproxy categories configuration by ID</td>
  </tr> 
    <tr>
    <td>POST</td><td>/ffproxy/safesearch</td><td>To create safesearch configuration</td>
  </tr>
  <tr>
    <td>GET</td><td>/ffproxy/safesearch</td><td>List summary of safesearch configuration</td>
  </tr>
  <tr>
    <td>GET</td><td>/ffproxy/safesearch/:id</td><td>List summary of safesearch configuration by ID</td>
  </tr>
  <tr>
    <td>PUT</td><td>/ffproxy/safesearch/:id</td><td>Update existing safesearch configuration in VCG/CPEs by ID</td>
  </tr>
  <tr>
    <td>DELETE</td><td>/ffproxy/safesearch/:id</td><td>To delete existing safesearch configuration by ID</td>
  </tr>

 <tr>
    <td>POST</td><td>/ffproxy/policyexceptions</td><td>To create exception configuration</td>
  </tr>
  <tr>
    <td>GET</td><td>/ffproxy/policyexceptions</td><td>List summary of exception configuration</td>
  </tr>
  <tr>
    <td>GET</td><td>/ffproxy/policyexceptions/:id</td><td>List summary of exception configuration by ID</td>
  </tr>
  <tr>
    <td>PUT</td><td>/ffproxy/policyexceptions/:id</td><td>Update existing exception configuration in VCG/CPEs by ID</td>
  </tr>
  <tr>
    <td>DELETE</td><td>/ffproxy/policyexceptions/:id</td><td>To delete existing exception configuration by ID</td>
  </tr> 
</table>


Create ffproxy policy
------------------------------------


    Verb      URI                    Description
    POST      /ffproxy/policy        Create ffproxy policy configuration.

On success it returns JSON data with the UUID for the ffproxy policy created configuration.

**Example Request and Response**

### Request JSON
    {
    
    "policy": [
        {
            "enable": true,
            "name": "policy name",
            "allowList": [
                1,
                2,
                3
            ],
            "blockedList": [
                4,
                5
            ],
            "net": [
                {
                    "network": "10.1.10.1",
                    "netmask": 32
                },
                {
                    "network": "10.1.10.3",
                    "netmask": 32
                }
            ]
        },
        {
              "enable": true,
              "name": "policy name 2",
            "allowList": [
                4,
                5
            ],
            "blockedList": [
                6,
                7
            ],
            "net": [
                {
                    "network": "10.1.10.2",
                    "netmask": 32
                }
            ]
        }
    ]
    }

### Response JSON

    {
       
       "policy":
       [
           {
               "enable": true,
               "name": "policy name",
               "allowList":
               [
                   1,
                   2,
                   3
               ],
               "blockedList":
               [
                   4,
                   5
               ],
               "net":
               [
                   {
                       "network": "10.1.10.1",
                       "netmask": 32
                   },
                   {
                       "network": "10.1.10.3",
                       "netmask": 32
                   }
               ]
           },
           {
               "enable": true,
               "name": "policy name 2",
               "allowList":
               [
                   4,
                   5
               ],
               "blockedList":
               [
                   6,
                   7
               ],
               "net":
               [
                   {
                       "network": "10.1.10.2",
                       "netmask": 32
                   }
               ]
           }
       ],
       "id": "89a81ef3-99bf-4a60-b9c8-f7abfa7cc428"
    }



List ffproxy policy
----------------------------

    Verb	URI	             Description
    GET	       /ffproxy/policy       List summary of ffproxy policy configuration.

**Example Request and Response**

*Response*

    [
       {
           "policy":
           [
               {
                   "enable": true,
                   "name": "policy name",
                   "allowList":
                   [
                       1,
                       2,
                       3
                   ],
                   "blockedList":
                   [
                       4,
                       5
                   ],
                   "net":
                   [
                       {
                           "network": "10.1.10.1",
                           "netmask": 32
                       },
                       {
                           "network": "10.1.10.3",
                           "netmask": 32
                       }
                   ]
               },
               {
                   "enable": true,
                   "name": "policy name 2",
                   "allowList":
                   [
                       4,
                       5
                   ],
                   "blockedList":
                   [
                       6,
                       7
                   ],
                   "net":
                   [
                       {
                           "network": "10.1.10.2",
                           "netmask": 32
                       }
                   ]
               }
           ],
           "id": "89a81ef3-99bf-4a60-b9c8-f7abfa7cc428"
       }
    ]


    



List ffproxy policy by ID
----------------------------------

    Verb	URI	                Description
    GET	       /ffproxy/policy/:id	List summary of ffproxy policy configured by ID.

**Example Request and Response**

*Response*

    {
       
       "policy":
       [
           {
               "enable": true,
               "name": "policy name",
               "allowList":
               [
                   1,
                   2,
                   3
               ],
               "blockedList":
               [
                   4,
                   5
               ],
               "net":
               [
                   {
                       "network": "10.1.10.1",
                       "netmask": 32
                   },
                   {
                       "network": "10.1.10.3",
                       "netmask": 32
                   }
               ]
           },
           {
               "enable": true,
               "name": "policy name 2",
               "allowList":
               [
                   4,
                   5
               ],
               "blockedList":
               [
                   6,
                   7
               ],
               "net":
               [
                   {
                       "network": "10.1.10.2",
                       "netmask": 32
                   }
               ]
           }
       ],
       "id": "89a81ef3-99bf-4a60-b9c8-f7abfa7cc428"
    }




Update ffproxy policy
----------------------


    Verb	URI	              Description
    PUT 	/ffproxy/policy/:id   update ffproxy policy configuration by ID.

On success it returns JSON data with the UUID for the ffproxy policy created configuration.

**Example Request and Response**

### Request JSON
    {
    
    "policy": [
        {
            "enable": true,
            "name": "policy name1",
            "allowList": [
                1,
                2,
                3
            ],
            "blockedList": [
                4,
                5
            ],
            "net": [
                {
                    "network": "10.1.10.1",
                    "netmask": 32
                },
                {
                    "network": "10.1.10.3",
                    "netmask": 32
                }
            ]
        },
        {
            "enable": true,
            "name": "policy name 2",
            "allowList": [
                4,
                5
            ],
            "blockedList": [
                6,
                7
            ],
            "net": [
                {
                    "network": "10.1.10.2",
                    "netmask": 32
                }
            ]
        }
    ]
    }
    

### Response JSON

    {
       
       "policy":
       [
           {
               "enable": true,
               "name": "policy name1",
               "allowList":
               [
                   1,
                   2,
                   3
               ],
               "blockedList":
               [
                   4,
                   5
               ],
               "net":
               [
                   {
                       "network": "10.1.10.1",
                       "netmask": 32
                   },
                   {
                       "network": "10.1.10.3",
                       "netmask": 32
                   }
               ]
           },
           {
               "enable": true,
               "name": "policy name 2",
               "allowList":
               [
                   4,
                   5
               ],
               "blockedList":
               [
                   6,
                   7
               ],
               "net":
               [
                   {
                       "network": "10.1.10.2",
                       "netmask": 32
                   }
               ]
           }
       ],
       "id": "89a81ef3-99bf-4a60-b9c8-f7abfa7cc428"
    }



DELETE policy
-------------

    Verb      URI                            Description
    DELETE   /ffproxy/policy/:id           Delete existing ffproxy policy configuration by ID.

**Example Request and Response**

### Request Headers

    DELETE /ffproxy/policy/d8fc22ff-3024-4937-bf18-cfbca8010e34

### Response Header

   Status Code : 204



Create ffproxy categories
-----------------------


    Verb	URI	              Description
    POST	/ffproxy/categories     Create ffproxy categories configuration.

On success it returns JSON data with the UUID for the ffproxy categories created configuration.

**Example Request and Response**

### Request JSON

    {
    "categories": [
        {
            "categoryNumber": 42,
            "name": "test",
            "description": "test desc",
            "urls": [
                "test",
                "test1"
            ],
            "custom": true
        },
        {
            "categoryNumber": 43,
            "name": "test",
            "description": "test desc",
            "urls": [
                "test",
                "test1"
            ],
            "custom": true
        }
    ]
    }

### Response JSON

    {
       "categories":
       [
           {
               "categoryNumber": 42,
               "name": "test",
               "description": "test desc",
               "urls":
               [
                   "test",
                   "test1"
               ],
               "custom": true
           },
           {
               "categoryNumber": 43,
               "name": "test",
               "description": "test desc",
               "urls":
               [
                   "test",
                   "test1"
               ],
               "custom": true
           }
       ],
       "id": "afbdb284-a18a-41b9-b057-b641fd5d108c"
    }



List ffproxy categories 
----------------------------

    Verb	URI	               Description
    GET	       /ffproxy/categories       List summary of ffproxy categories configuration.

**Example Request and Response**

*Response*

    [
       {
           "categories":
           [
               {
                   "categoryNumber": 42,
                   "name": "test",
                   "description": "test desc",
                   "urls":
                   [
                       "test",
                       "test1"
                   ],
                   "custom": true
               },
               {
                   "categoryNumber": 43,
                   "name": "test",
                   "description": "test desc",
                   "urls":
                   [
                       "test",
                       "test1"
                   ],
                   "custom": true
               }
           ],
           "id": "afbdb284-a18a-41b9-b057-b641fd5d108c"
       }
    ]



List ffproxy categories by ID
-----------------------------

    Verb	URI	                Description
    GET	       /ffproxy/categories/:id	List summary of ffproxy categories configured by ID.

**Example Request and Response**

*Response*

    {
       "categories":
       [
           {
               "categoryNumber": 42,
               "name": "test",
               "description": "test desc",
               "urls":
               [
                   "test",
                   "test1"
               ],
               "custom": true
           },
           {
               "categoryNumber": 43,
               "name": "test",
               "description": "test desc",
               "urls":
               [
                   "test",
                   "test1"
               ],
               "custom": true
           }
       ],
       "id": "afbdb284-a18a-41b9-b057-b641fd5d108c"
    }




Update ffproxy categories
------------------------


    Verb	URI	              Description
    PUT	      /ffproxy/categories/:id   update ffproxy categories configuration by ID.

On success it returns JSON data with the UUID for the ffproxy categories created configuration.

**Example Request and Response**

### Request JSON

    {
    "categories": [
        {
            "categoryNumber": 42,
            "name": "test",
            "description": "test desc updated",
            "urls": [
                "test",
                "test1"
            ],
            "custom": true
        },
        {
            "categoryNumber": 43,
            "name": "test",
            "description": "test desc",
            "urls": [
                "test",
                "test1"
            ],
            "custom": true
        }
    ]
    }

### Response JSON
    {
       "categories":
       [
           {
               "categoryNumber": 42,
               "name": "test",
               "description": "test desc updated",
               "urls":
               [
                   "test",
                   "test1"
               ],
               "custom": true
           },
           {
               "categoryNumber": 43,
               "name": "test",
               "description": "test desc",
               "urls":
               [
                   "test",
                   "test1"
               ],
               "custom": true
           }
       ],
       "id": "afbdb284-a18a-41b9-b057-b641fd5d108c"
    }



DELETE categories
----------------

    Verb      URI                          Description
    DELETE   /ffproxy/categories/:id         Delete existing ffproxy categories configuration by ID.

**Example Request and Response**

### Request Headers

    DELETE /ffproxy/categories/488ef428-a495-4eac-817f-37d0f2bac363

### Response Header

   Status Code : 204


Safesearch
----------

    Verb      URI                       Description
    POST     /ffproxy/safesearch        safesearch  configuration.

On success it returns JSON data with the UUID for the safesearch created configuration.

**Example Request and Response**

### Request JSON




    {
       "safesearch":
       {
           "enable": false
       }
       
    }




### Response JSON

    

    {
       "safesearch":
       {
           "enable": false
       },
       "id": "3cef41a7-f960-465f-8fb0-9c724ed43fa1"
    }




**GET List**

    Verb       URI	                    Description
    GET	       /ffproxy/safesearch    	List summary of safesearch configured.

**Example Request and Response**

### Response JSON

    

    [
       {
           "safesearch":
           {
               "enable": false
           },
           "id": "3cef41a7-f960-465f-8fb0-9c724ed43fa1"
       }
    ]



**GET by ID:**

    Verb       URI                          Description
    GET	       /ffproxy/safesearch/:id    	List summary of safesearch configured by ID.

**Example Request and Response**

### Response JSON



    {
       "safesearch":
       {
           "enable": false
       },
       "id": "3cef41a7-f960-465f-8fb0-9c724ed43fa1"
    }


**PUT API**

    Verb       URI                          Description
    PUT	       /ffproxy/safesearch/:id    	Update safesearch configuration.

**Example Request and Response**

### Request JSON

    {
       "safesearch":
       {
           "enable": true
       }
       
    }

### Response JSON

    {
       "safesearch":
       {
           "enable": true
       },
       "id": "3cef41a7-f960-465f-8fb0-9c724ed43fa1"
    }




### DELETE safesearch configuration


    Verb      URI                            Description
    DELETE   /ffproxy/safesearch/:id         Delete existing safesearch configuration by ID.

**Example Request and Response**

### Request Headers

    DELETE /ffproxy/safesearch/265875ff-643f-47b8-bd1c-23b35e5bda8e

### Response Header

   Status Code : 204


Exceptions
----------

    Verb      URI                       Description
    POST     /ffproxy/policyexceptions        exceptions  configuration.

On success it returns JSON data with the UUID for the exceptions created configuration.

**Example Request and Response**

### Request JSON

    {
    "policyexceptions": [
        {
            "name": "Default Policy exceptions",
            "custom": false,
            "whitelist": [
                "test1",
                "test2"
            ],
            "net": [
                {
                    "network": "0.0.0.0",
                    "netmask": 0
                }
            ]
        },
        {
            "name": "Default Policy exceptions",
            "custom": false,
            "blacklist": [
                "test3",
                "test4"
            ],
            "net": [
                {
                    "network": "0.0.0.0",
                    "netmask": 0
                }
            ]
        }
    ]
    }

    


### Response JSON

    {
       "policyexceptions":
       [
           {
               "name": "Default Policy exceptions",
               "custom": false,
               "whitelist":
               [
                   "test1",
                   "test2"
               ],
               "net":
               [
                   {
                       "network": "0.0.0.0",
                       "netmask": 0
                   }
               ]
           },
           {
               "name": "Default Policy exceptions",
               "custom": false,
               "blacklist":
               [
                   "test3",
                   "test4"
               ],
               "net":
               [
                   {
                       "network": "0.0.0.0",
                       "netmask": 0
                   }
               ]
           }
       ],
       "id": "6efee6eb-cfc2-4465-b2b7-999316d1af1e"
    }



**GET List**

    Verb       URI	                    Description
    GET	       /ffproxy/policyexceptions    	List summary of exceptions configured.

**Example Request and Response**

### Response JSON

    [       
       {
       "policyexceptions":
       [
           {
               "name": "Default Policy exceptions",
               "custom": false,
               "whitelist":
               [
                   "test1",
                   "test2"
               ],
               "net":
               [
                   {
                       "network": "0.0.0.0",
                       "netmask": 0
                   }
               ]
           },
           {
               "name": "Default Policy exceptions",
               "custom": false,
               "blacklist":
               [
                   "test3",
                   "test4"
               ],
               "net":
               [
                   {
                       "network": "0.0.0.0",
                       "netmask": 0
                   }
               ]
           }
       ],
       "id": "6efee6eb-cfc2-4465-b2b7-999316d1af1e"
    }
    ]

**GET by ID:**

    Verb       URI                          Description
    GET	       /ffproxy/policyexceptions/:id    	List summary of exception configured by ID.

**Example Request and Response**

### Response JSON



    {
       "policyexceptions":
       [
           {
               "name": "Default Policy exceptions",
               "custom": false,
               "whitelist":
               [
                   "test1",
                   "test2"
               ],
               "net":
               [
                   {
                       "network": "0.0.0.0",
                       "netmask": 0
                   }
               ]
           },
           {
               "name": "Default Policy exceptions",
               "custom": false,
               "blacklist":
               [
                   "test3",
                   "test4"
               ],
               "net":
               [
                   {
                       "network": "0.0.0.0",
                       "netmask": 0
                   }
               ]
           }
       ],
       "id": "6efee6eb-cfc2-4465-b2b7-999316d1af1e"
    }



**PUT API**

    Verb       URI                          Description
    PUT	       /ffproxy/policyexceptions/:id    	Update exception configuration.

**Example Request and Response**

### Request JSON

    {
    "policyexceptions": [
        {
            "name": "Default Policy exceptions",
            "custom": false,
            "whitelist": [
                "test11",
                "test21"
            ],
            "net": [
                {
                    "network": "0.0.0.0",
                    "netmask": 0
                }
            ]
        },
        {
            "name": "Default Policy exceptions",
            "custom": false,
            "blacklist": [
                "test31",
                "test41"
            ],
            "net": [
                {
                    "network": "0.0.0.0",
                    "netmask": 0
                }
            ]
        }
    ]
    }	

### Response JSON

    {
       "policyexceptions":
       [
           {
               "name": "Default Policy exceptions",
               "custom": false,
               "whitelist":
               [
                   "test11",
                   "test21"
               ],
               "net":
               [
                   {
                       "network": "0.0.0.0",
                       "netmask": 0
                   }
               ]
           },
           {
               "name": "Default Policy exceptions",
               "custom": false,
               "blacklist":
               [
                   "test31",
                   "test41"
               ],
               "net":
               [
                   {
                       "network": "0.0.0.0",
                       "netmask": 0
                   }
               ]
           }
       ],
       "id": "6efee6eb-cfc2-4465-b2b7-999316d1af1e"
    }

### DELETE exception configuration


    Verb      URI                            Description
    DELETE   /ffproxy/policyexceptions/:id         Delete existing exception configuration by ID.

**Example Request and Response**

### Request Headers

    DELETE /ffproxy/policyexceptions/6efee6eb-cfc2-4465-b2b7-999316d1af1e

### Response Header

   Status Code : 204

---
_Source: https://npm.io/package/cloudflash-ffproxy · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
