Databridges NACL wrapper gives you a simple write and read function using implementation of the secretbox encryption standard defined in NaCl.
Databridges NACL wrapper is available for
The above wrappers can be used to send encrypted messages between them.
The Databridges NACL wrapper for iOS Swift Language binding uses
TweetNacl
to deliver implementation of the secretbox encryption standard defined in NaCl.
The following topics are covered:
- Supported platforms
- Installation.
- Initialization
- Global Configuration
- How to use with Databridges iOS Swift Library
- Change Log
- License
-
Swift 5.0 and above
-
Deployment targets iOS 13.0 and above
To add databridges_nacl_wrapper
package dependency to your Xcode project, select File > Swift Packages > Add Package Dependency... and enter repository URL https://github.com/databridges-io/lib.ios.nacl.wrapper.git
.
When you enter the package dependency’s URL, choose Version package requirements, select the latest version. Xcode resolves and fetches the package dependency. Select the package’s products that you need, and add them to targets in your project.
In Xcode Project navigator, the Swift Package Dependencies section shows the newly added databridges_nacl_wrapper
package dependency. Click the disclosure triangle to view the contents of the package as it exists locally on your Mac.
import databridges_nacl_wrapper
public var secretData:databridges_nacl_wrapper = databridges_nacl_wrapper()
The following is the required properties before using to dataBridges NaCl wrapper.
secretData.secret = '32 char alphanumeric string'
Properties | Description |
---|---|
secret |
(string) 32 char alpha numeric string. NaCl encryption secret. |
To encrypt data using NaCl, databridges wrapper exposes a method named write
, This will return encrypted data if successful else it will throw error.
do {
let encData = try secretData.write("Your Data..")
print("Encrypted:", encData)
} catch {
let err = error as? dbnwError
print("Errors:" , err!.source , err!.code , err!.message)
}
Parameter | Description |
---|---|
data |
(string) data to be encrypted. |
Return Values | Description |
---|---|
string |
Encrypted string. |
Source | Code | Description |
---|---|---|
DBLIB_NACL_WRAPPER | INVALID_SECRET | secret is not set with the wrapper instance. |
DBLIB_NACL_WRAPPER | INVALID_DATA | If data is not passed to the function. |
DBLIB_NACL_WRAPPER | NACL_EXCEPTION | Exceptions generated by NaCl library. |
To decrypt data using NaCl, databridges wrapper exposes a method named read
, This will return decrypted data if successful else it will throw error.
do {
let decData = try secretData.read("<Encrypted data.>")
print("Decrypted:", decData)
} catch {
let err = error as? dbnwError
print("Errors:" , err!.source , err!.code , err!.message)
}
Parameter | Description |
---|---|
data |
(string) data to be encrypted. |
Return Values | Description |
---|---|
string |
Encrypted string. |
Source | Code | Description |
---|---|---|
DBLIB_NACL_WRAPPER | INVALID_SECRET | secret is not set with the wrapper instance. |
DBLIB_NACL_WRAPPER | INVALID_DATA | If data is not passed to the function OR data is not a valid encrypted string. |
DBLIB_NACL_WRAPPER | NACL_EXCEPTION | Exceptions generated by NaCl library. |
DBLIB_NACL_WRAPPER | NACL_DECRYPT_FAILED | If decryption fails due to invalid secret or manipulated data. |
Below code shows how to integrate the NaCl wrapper with the Databridges library. After initialize you can use the wrapper library to encrypt and decrypt the data when publishing and receiving events.
// Initialize both databridges-sio-client-lib and databridges-nacl-wrapper
import databridges_sio_swift_client
import databridges_nacl_wrapper
public var dbridge:databridges_sio_swift_client = databridges_sio_swift_client()
public var secretData:databridges_nacl_wrapper = databridges_nacl_wrapper()
secretData.secret = "Your32 char secret.";
// .... Your databridges code comes here.
// On Subscription success event.
try? self.subscribeChannel?.bind("dbridges:subscribe.success", {(event: Any, metadata: MetaData) in
var mflag:Bool = false
var encData:String = ""
do {
encData = try secretData.write("Your Data..");
mflag = true
} catch {
let db = error as? dbnwError
print("Error :" , db!.source , db!.code , db!.message)
}
if mflag {
try? self.subscribeChannel?.publish("eventName", encData, 1)
}
});
// On payload Received event.
try? self.subscribeChannel?.bind("eventName", {(event: Any, metadata: MetaData) in
var decData:String = ""
do {
decData = try secretData.read((event as! String))
} catch {
let db = error as? dbnwError
print("Error :", db!.source, db!.code, db!.message)
}
if !decData.isEmpty {
print("Decrypted: \(String(describing: decData))" )
}
});
- Change log: Changes in the recent versions
DataBridges NaCl Wrapper is released under the MIT license.
Copyright 2022 Optomate Technologies Private Limited.
Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
"Software"), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:
The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.