Skip to content

Conversation

@daniellevass
Copy link
Contributor

What

Added docs

@daniellevass daniellevass self-assigned this Apr 6, 2020
@daniellevass daniellevass changed the title add some Private Encrypted Channels docs Private Encrypted Channels docs Apr 7, 2020
README.md Outdated
Similar to Private channels, you can also subscribe to a
[private encrypted channel](https://pusher.com/docs/channels/using_channels/encrypted-channels)
which means the data passed through Pusher is encrypted and only possible to
decrypt using the shared secret you have have.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

have have

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤦‍♀ haha

README.md Outdated
[demonstration endpoint to look at using nodejs](https://github.com/pusher/pusher-channels-auth-example#using-e2e-encryption).

To get started you need to subscribe to your channel, provide a `PrivateEncryptedChannelEventListener`
listener, and a list of the events you are interested in, for example:

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

...Listener listener

maybe drop the second listener? idk though it's not wrong it just sounds odd.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍 thank you! i originally had it there because i use listener on it's own in the example, but i think it's probably unnecessary.

@codecov-io
Copy link

codecov-io commented Apr 7, 2020

Codecov Report

Merging #250 into decrypt-integration will increase coverage by 0.56%.
The diff coverage is 0.00%.

Impacted file tree graph

@@                    Coverage Diff                    @@
##             decrypt-integration     #250      +/-   ##
=========================================================
+ Coverage                  77.02%   77.58%   +0.56%     
- Complexity                   270      299      +29     
=========================================================
  Files                         33       33              
  Lines                       2350     2445      +95     
  Branches                     115      125      +10     
=========================================================
+ Hits                        1810     1897      +87     
- Misses                       488      495       +7     
- Partials                      52       53       +1     
Impacted Files Coverage Δ Complexity Δ
...ent/example/PrivateEncryptedChannelExampleApp.java 0.00% <0.00%> (ø) 0.00 <0.00> (ø)
...ient/channel/impl/PrivateEncryptedChannelImpl.java 96.49% <0.00%> (-1.63%) 32.00% <0.00%> (+15.00%) ⬇️
...va/com/pusher/client/channel/impl/ChannelImpl.java 94.78% <0.00%> (-0.46%) 42.00% <0.00%> (+14.00%) ⬇️

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update d346cea...f23a1b9. Read the comment docs.

@daniellevass daniellevass marked this pull request as ready for review April 7, 2020 09:52
README.md Outdated
Similar to Private channels, you can also subscribe to a
[private encrypted channel](https://pusher.com/docs/channels/using_channels/encrypted-channels)
which means the data passed through Pusher is encrypted and only possible to
decrypt using the shared secret you have.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not quite sure about the final part of this sentence - whether it conveys the capability of the encryption clearly.

For reference, see the wording on the node server library, first sentence here: https://github.com/pusher/pusher-http-node#end-to-end-encryption-beta.

Copy link
Contributor Author

@daniellevass daniellevass Apr 7, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah, I struggled with the correct terminology to use - I've updated it to read:

Similar to Private channels, you can also subscribe to a
[private encrypted channel](https://pusher.com/docs/channels/using_channels/encrypted-channels).
This library now fully supports end-to-end encryption. 
This means that only you and your connected clients will be able to read 
your messages. Pusher cannot decrypt them.

Does that make it clearer?

ConnectionEventListener, PrivateEncryptedChannelEventListener {

private String apiKey = "FILL_ME_IN"; // "key" at https://dashboard.pusher.com
private String key = "FILL_ME_IN";
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think with so little context to the variable name, it's worth keeping at least a comment directing people to the dashboard to get one.

In general, I think apiKey is a pretty common term and will help people grasp quicker where they would probably find it.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've written in the comment at the top of the file they can get all that info from the dashboard - but i think your right the variable name should be more descriptive - maybe even channelsKey?

@daniellevass daniellevass merged commit 63ca0d0 into decrypt-integration Apr 7, 2020
@daniellevass daniellevass deleted the dev-private-encrypted-channels-docs branch April 7, 2020 15:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants